Manual 


SA21-9247-6 ~~ Fs 


IBM 5250 
Information Display System 


Functions Reference 


SA21-9247-6 


IBM 5250 
Information Display System 


Functions Reference 
Manual 


File Number 
S/5250-06,08,09 


Seventh Edition (March 1987) 


This major revision makes obsolete SA21-9247-5 and Technical Newsletters SN21-0403 
and SN21-0407. Information on the IBM Enhanced Keyboard has been added. Miscella- 
neous technical changes and additions have also been made. Changes are periodically 
made to the information herein; these changes will be reported in technical newsletters 
or in new editions of this publication. 


This publication is for system programmers familiar with systems network architecture 
(SNA) and synchronous data link control (SDLC). It contains information about pro- 
gramming the 5250 Information Display System devices. This publication contains 
examples of the data streams used by the 5250 devices. All names used in these exam- 
ples are fictitious and any similarity to names or addresses used by an actual business 
enterprise is coincidental. 


This document is provided for use in conjunction with other IBM publications, and IBM 
makes no warranty, express or implied, relative to its compieteness or accuracy. The 
information in this document is current as of the date of its publication, but is subject to 
change at any time without notice. 


The document is not intended to be a performance or functional specification. It 
assumes that the user has an understanding of the interrelationship among any 
affected systems, machines, programs, or media. Use this publication only for the pur- 
poses stated in the About This Manual section. 


IBM may have patents or pending patent applications covering subject matter 
described in this document, including appearance design patents or applications. The 
furnishing of this document does not constitute or imply a grant of any license under 
any patents, patent applications, trademarks, copyrights or other rights of IBM or of any 
third party, or any right to refer to IBM in advertising or other promotional or marketing 
activities. IBM assumes no responsibility for any infringement of patents or other rights 
that may result from use of this document or from the manufacture, use, lease, or sale 
of apparatus described herein. 


it is possible that this material might contain reference to, or information about, IBM 
products (machines and programs), programming, or services that are not announced 
in your country. Such references or information must not be construed to mean that 
IBM intends to announce such IBM products, programming, or services in your country. 


Publications are not stocked at the address below. Requests for copies of IBM publica- 
tions and for technical information about the system should be made to your IBM repre- 
sentative or to the branch office serving your locality. 


This publication could contain technical inaccuracies or typographical errors. Use the 
Reader’s Comment Form at the back of this publication to make comments about this 
publication. If the form has been removed, address your comments to IBM Corporation, 
Raleigh Information Development, Department E02, Research Triangle Park, North 
Carolina, U.S.A. 27709. IBM may use and distribute any of the information you supply in 
any way it believes appropriate without incurring any obligation whatever. You may, of 
course, continue to use the information you supply. 


© Copyright International Business Machines Corporation 1978, 1986, 1987 


Contents 


Section 1. Description of the 5250 Information 


Display System ......... 2c ccc ewe ann nee 1-1 
General Functional Information .............. 1-1 
Functional Characteristics of the 5251 Models 
2 and 12 and 5294 in Remote Operations ... 1-1 
Overview of 5250 Implementation of SDLC ... 1-1 
Overview of the 5250 Implementation of SNA _ . 1-3 
Addressing in the 5250 System .............. 1-5 
Controller Station Address ............... 1-7 
Work Station Address ................05. 1-7 
LSID and Local Station Address .......... 1-10 
Error Handling in the 5250 System .......... 1-10 
Operator Errors: cree oie tice eee ees 1-12 
FMD Programming Errors ............... 1-12 
SNA Protocol Errors ...........02 0c eee 1-12 
Hardware Errors ............00 2 eee eeee 1-12 
SNA Session FIOW ............ 0020s eee 1-14 
SNA Session Control and Data Flow ....... 1-17 
Establishing aSession .................. 1-21 
Establishing a User Program to LU 
Flow-Binding ............ 000 e eee ees 1-21 
SIGNING: ON" xcs Slee Sone ch Oe She ead 1-21 
User-LU Communication ................ 1-22 
Protocols and Synchronization for 5250 
Implementation of SNA ................0.. 1-22 
Terminology Used in Describing the SNA 
PEOLOCOIG(: eft etiis aeaticiadd a aie e- ae nee acai 1-23 
Display Protocols .................2005.% 1-25 
Printer Protocols ..................000% 1-26 
Requesting Status from an IPDS Printer .... 1-27 
Display Data Stream Example .............. 1-28 
Writing toa Display .................... 1-28 
Building an Alphanumeric Display ........ 1-29 
Building a Graphics Display ............. 1-33 
Reading Fields from a Display ........... 1-37 
Error Identification and Recovery ......... 1-38 
Printer Data Stream Example .............. 1-39 
Section 2. Encyclopedia .............cee00: 2-1 
AGCIGSSOS: . bude cate eerie eat ube tamaws 2-1 
ASCW!. 2h haere howd eames secede bess eure 2-2 
Aid GOd@S) 5. 6424::33.44 6st cede Sh Cher Awe eee 2-2 
Buffer Print Mode (4224, 5224, and 5225 Printers) 2-3 
Procedure for the 4224 ................... 2-3 
Procedures for the 5224 .................. 2-3 
Procedures for the 5225 .................. 2-3 
CD (Change of Direction) Bit ................ 2-4 
Calming: va A deasthd a eee caeeewen eke a 2-4 
Clock (Synchronous) .................00005 2-4 


Color Alignment (5292 Only) ................ 2-4 
COMMANGS= «3.8 rise Giasete trae nee dee bee SS 2-4 
Display Data Stream Commands ........... 2-4 
Input Commands ............. 0.0 ee eee 2-5 
Output Commands ............... 00 eens 2-9 
SDLC Commands and Responses ......... 2-15 
SNA Commands ................000 0008: 2-22 
Transmission Commands ............... 2-36 
Common Carrier Services ................. 2-36 
Domestic Services ................0000% 2-36 
World Trade Common Carrier Services .... 2-36 
5294 Communications Features ............. 2-37 
EIA/CCITT Interface Adapter ............. 2-37 
MECA AGapte?” sas4e%d2euiedeedewnewees 2-37 
Digital Data Service Adapter (DDSA) ...... 2-37 
Communications Network Errors ............ 2-38 
Control Characters ...................0058. 2-39 
DISDIAY 6h. caret tad Gate eae eee 2-39 
UML. 48: aas-ace eta. O15, idence dod eye ob, eaves 2-41 
Copy to Printer Feature ................... 2-50 
Data Streams ............ 0.00.0 cee eee 2-50 
Display ........ 0.0.00... ccc eee ee 2-51 
PHUOt@r’ «ic. cig Ss 34 Denese Bah ag SA ee 2-51 
Digital Data Service Adapter ............... 2-51 
EBCDIC Character Sets ................... 2-51 
EIA/CCITT Adapter ................00 0008. 2-65 
Etror Log: 2tehatnd oe tk eles deh bed Aes 2-65 
Field Control Word (FCW) ................. 2-65 
Magnetic Stripe Reader Feature .......... 2-66 
RESEGUGNCING: s465444 ee ies eae ed wed 2-66 
Selector Light Pen Feature .............. 2-67 
Self-Check Feature ..................0.. 2-67 
Field Format Word (FFW) .................. 2-68 
PIGIOS). c.o45- 515-54: Sa ele a ee oe Ree aed . 2-69 
Format Level. 0:3. 226 62s tate tamed hes 2-71 
Format Tablee ve2 2 t05 wundd dae 48S ie oes 2-71 
Frame = SDLC! sid Sea ee Pia See bs 2-71 
Graphics Introduction ..................... 2-73 
5292 Select Options .................... 2-73 
Graphic Display Indicators .............. 2-73 
Graphic and I/O Feature Orders .......... 2-74 
Pacing, bis plete Ga eas aa era 2-74 
Graphic and I/O Feature Orders ............ 2-75 
Graphic Control Orders ................. 2-77 
Graphic Set Orders .................... 2-80 
Graphic Draw Orders .................4. 2-90 
Read Orders sec bee kb ek be eae ees 2-98 
1/O Feature Printer Orders ............... 2-98 
|/O Feature IEEE-488 Interface Orders 2-102 


Contents _ iii 


Printer and IEEE Data ................. 2-104 
EFPOr FanGling.<.g a%e aot Ge eee Fa ea Be 2-105 
PAGING) Gadd 2-3 uy dpe bebvenia eae ecalec h ak Ao ede e iis 2-107 
Pacing Description ...................4. 2-107 
Graphic Aid Key Codes ................ 2-108 
I/O Feature Information .................. 2-109 
IEEE-488 Digital Interface for Plotters ..... 2-109 
Video Interface ..................0000.4 2-109 
Parallel Printer Interface ............... 2-112 
IO Se aed cl oiee see ek eR eos eae ents Gee ee, eee 2-117 
Aid-Generating Keys ................4-. 2-117 
Signal KeyS ................00.000006 2-121 
Special Control Keys .................. 2-123 
Special Host Keys ...............0005. 2-126 
MDT Bit 234-0 s ins cea eee eee ae ek 2-128 
MOGGMS: ee oc tego tidaus do eae he eae eee 2-128 
Modes—SDLC .............. 0.0 cee ees 2-129 
Multinational Character Set ............... 2-129 
Negative Responses .................04. 2-132 
Operator Error Codes .................0. 2-135 
OIdGeCts. ship 64 mated oe okt zat Wie Sind. AotteHs ie 2-136 
Pee BUt ero bee ses cmce Been tiara hia otarra nf eas 2-140 
PACING: Jactar-titetoa Ahura Site es td ea as te we 2-140 
Request/Response Header (RH) ........... 2-141 
RU (Request/Response Unit) .............. 2-142 
Screen Attributes .................. 00005 2-142 
SDLC/Counter Error Codes (O06X) .......... 2-144 
SNA ChainEnd ............. 2... 0 00 c ee 2-144 
States and Modes ................0000005 2-145 
Hardware Error State .................. 2-145 
Normal Locked State .................. 2-145 
Normal Unlocked State ................ 2-146 
Posthelp Error State .................. 2-146 
Power-On State ............. 0002 eee 2-147 
Prehelp Error State .................0.. 2-147 
SS Message State ..................-. 2-148 
System Request State ................. 2-148 
TH (Transmission Header) ................ 2-159 
Expanded Cluster Feature ................ 2-160 
1200 bps Integrated Modem ............... 2-160 


2400 or 4800 bps Integrated Modem ........ 2-160 


M25 F@ature: dk otic A ike a ine eal iene 6 BAe 2-160 
X.25 Feature Functions ................ 2-161 
Frame Level Performance Characteristics . 2-161 
SNA/X.25 Relationship ................. 2-162 
Establishing and Closing an SVC/PVC 

CONMOCCHON © <6). 04 nie cose ec week eb See A 2-163 
Formats of Communications Components . 2-163 
LAPB Frames and Commands ........... 2-166 
PACK CUS ecto ac beara Seve Wn aia eae Bane Seas 2-166 
Logical Link Control (LLC) .............. 2-166 


Data Development with the X.25 Feature .. 2-175 
Examples of Signal Exchange During 


CONNECTION’ a\o 35% shee ew hee oe ha OES 2-177 
Errors and Problem Determination ....... 2-182 
SDLC Counter Error Codes (X.25 Only) .... 2-184 
Keyboard-Entered Options Error Codes 

O25. ON): achdtee oon esd ead awe Sees 2-185 
Network Communications Error Codes (X.25 

ONY): «ee wedded see nes ce 2-187 

X.21 Switched Circuit Feature ............. 2-192 
Supported Functions .................. 2-192 
5294 Interchange Connector ............ 2-192 
Communication Codes ................. 2-193 
X.21 Switched Circuit Operations ........ 2-196 
Short Hold Mode .................005. 2-197 
X.21 Network States ................06. 2-200 
Interface State Diagrams ............... 2-203 
SDLC Counter Error Codes (X.21) ........ 2-213 
Operator Error Codes (X.21 Switched 

Support Feature Only) ................ 2-214 
X.21 Communications Errors (X.21 Switched 

Support Feature Only) ................ 2-214 

Appendix A. Acronym and Abbreviation List .. A-1 

GIO8SOry’ 22 Gece le dees ereliteteest G-1 

GOK Sho ehibc ie aca aeicn ive palate awa he doh eee X-1 


iv IBM 5250 Information Display System Functions Reference Manual 


About This Manual 


The 5250 Information Display System is a cluster of 
work stations directly attached to a host system or 
attached to a host system by means of a remote work 
station controller. The remote work station controller 
can be a 5251 Model 2 or Model 12, or a 5294 Control 
Unit. 


Note: The 5251 Models 1 and 2 Display Stations and 
the 5252 Dual Display Station are no longer available. 
However, this manual does include information about 
these display stations for users who have these 
display stations installed. 


This manual describes the programming require- 
ments for communicating with the controller that con- 
trols all attached 5250 work stations. This manual 
also contains information that will allow a system 
programmer to implement a configuration using the 
5250 system and to determine problem-causing areas 
within the remote link to that system. 


There is no separate functions reference manual for 
the 5251 Models 1 and 11 Display Stations, the 5291 
Display Station, the 5292 Color Display Station, the 
5252 Dual Display Station, the 5224 Printer, the 5225 
Printer, or the 5256 Printer. For information about 
developing a program to control one of these work 
stations, the programmer should refer to this manual 
or to the functions reference manual for the host 
system. 


The 5250 controller can use the SDLC/SNA protocols 
and commands to establish, maintain, and regulate 
communications between itself and the host system. 
The programmer using this manual must be familiar 
with both SDLC and SNA. Details given about SDLC 
and SNA are only in respect to the specific protocols 
and commands that the 5250 implements. 


The 5294 Control Unit does not use the SDLC protocol 
with the X.25 feature. The protocols used with X.25 


networks are described in the /BM X.25 Interface for 
Attaching IBM SNA Nodes to Packet-Switched Data 
Networks, General Information Manual, GA27-3345. 


The 5294 Control Unit with the X.21 Circuit Switched 
feature uses an additional protocol to establish the 
connection with the network. This protocol is 
described in the /BM [mplementation of X.21 Interface 
General Information manual, GA27-3287. 


Purpose of This Manual 


The purpose of this manual is to give the system pro- 
grammer enough information about the 5250 to allow 
him to implement his own configurations and to 
create the data streams and SDLC/SNA linkages and 
controls necessary to solve program-related prob- 
lems. 


Organization of This Manual 


This manual is divided into two sections. Section 1 is 
for the reader who is unfamiliar with the 5250 system. 
It describes (1) the system, (2) basic SDLC and SNA 
concepts utilized by the system, and (3) basic terms 
necessary to understanding the presentation of the 
topics relating to SNA and SDLC. Examples of the 
5250 device data streams conclude Section 1. 


Section 2 is an encyclopedia that presents topics for 
use by the programmer familiar with the operation of 
the 5250 system but in need of specific detailed infor- 
mation about a particular area of the programming. 


Both sections use cross-references that lead the 
reader to other topics of interest. These cross- 
references take the form of the following example: 
See the index entry display, commands. 
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If You Need More Information 


The following setup procedures give step-by-step 
instructions for setup of each machine: 


Vi 


IBM 5251 Display Station Models 1 and 11 Setup 
Procedure, GA21-9286 


IBM 5251 Display Station Models 2 and 12 Setup 
Procedure, GA21-9289 


IBM 5291 Display Station Setup Procedure, 
GA21-9408 


IBM 5292 Color Display Station Setup Procedure, 
GA21-9415 


IBM 5252 Dual Display Station Setup Procedure, 
GA21-9288 


IBM 3180 Model 2 Display Station User's Guide, 
GA21-9469 


IBM 3196 Display Station Setup Instructions, 
GA18-2488 


IBM 5256 Printer Setup Procedure, GA21-9290 
IBM 5224 Printer Setup Procedure, GA34-0093 


IBM 5225 Printer Models 1, 2, 3, and 4 Setup Pro- 
cedure, GA34-0085 


IBM 5294 Setup Procedure, GA21-9369 


IBM 4224 Printer Product and Programming 
Description, GC31-2551 


IBM 4224 Printer Setup Instructions, GC31-3607 
IBM 4210 Printer Guide to Operations, SC31-3783 
IBM 4214 Printer Setup Instructions, GC31-2565 


IBM 4214 Printer Model 2 Product Description, 
GC31-2582 


IBM 5219 Printer Model D01/D02 Setup 
Procedures/Operator Guide, GA23-1019 


IBM 5262 Printer Model 1 Setup Instructions, 
GA24-3978 


IBM 3179 Model 2 Color Display Station Introduc- 
tion and Preinstallation Planning, GA18-2404 


The following operator’s guides describe the proce- 
dures required to operate each machine: 


IBM 5251 Display Station Models 1 and 11 and- 
IBM 5252 Dual Display Station Operator’s Guide, 
GA21-9248 


IBM 5251 Display Station Models 2 and 12 Opera- 
tor’s Guide, GA21-9323 


IBM 5291 Display Station Operator’s Guide, 
GA21-9409 


IBM 5292 Color Display Station Operator's Guide, 
GA21-9416. 


IBM 5256 Printer Operator’s Guide, GA21-9260 
IBM 5224 Printer Operator’s Guide, GA34-0092 


IBM 5225 Printer Models 1, 2, 3, and 4 Operator’s 
Guide, GA34-0054 


IBM 5294 Operator’s Guide, GA21-9370 


IBM 4224 Printer Operating Instructions, 
GC31-2546 


IBM 3180 Model 2 Display Station User's Guide, 
GA21-9469 


IBM 3196 Display Station User’s Guide, 
GA18-2482 


IBM 4210 Printer Product and Programming 
Description, SC31-3784 


IBM 4214 Printer Model 2 Operating Guide, 
GC31-2581 


IBM 5262 Printer Model 1 Operator’s Guide, 
GA24-3976 


IBM 3179 Model 2 Color Display Station User’s 
Guide, GA18-2387 
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The following publications might also be of interest: 


IBM 5250 Information Display Station System 
Introduction, GA21-9246, describes the work 
stations that make up the 5250 and their available 
functions and features. 


IBM 5250 Information Display System Planning 
and Site Preparation Guide, GA21-9337, provides 
environment, electrical, communications, space, 
furniture, and cable specifications to assist in 
planning for setup of the IBM 5250 Information 
Display System. This manual also provides infor- 
mation to help the system programmer configure 
the system and prepare instructions for setup 
personnel at remote sites. 


IBM Data Communications Concepts, GC21-5169, 
gives an introduction to teleprocessing for 
persons who plan to include a 5251 Model 2 or 
Model 12 in their system. 


IBM System Network Architecture General Infor- 
mation, GA27-3102, describes the terminology, 
concepts, and scope of system network architec- 
ture (SNA). 


IBM Synchronous Data Link Control General 
Information, GA27-3093, describes procedures 
that comprise synchronous data link control 
(SDLC), a brief background, and a basic 
description of the terminology and concepts of 
SDLC. 


IBM Implementation of X.21 Interface General 
Information, GA27-3287, describes the CCITT 
recommendation X.21 interface to Public Data 
Networks as implemented by IBM. 


IBM X.25 Interface for Attaching IBM SNA Nodes 


to Packet-Switched Data Networks, General Infor- 
mation, GA27-3345. 
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Section 1. Description of the 5250 Information Display System 


General Functional Information 


The 5251 Models 2 and 12 and the 5294 Control Unit 
contain the SNA support necessary to communicate 
with a host system. This includes LU 4 and 7 proto- 
cols. For a more detailed description of the operation 
of SNA, refer to the /BM Systems Network Architec- 
ture Format and Protocol Reference manual, 
SC30-3112. 


The 5251 Model 1 or Model 11, 5291, 5292, 5252, 5224, 
5225, 5256, 3180, 3196, and 4224 work stations are 
attached to the controller via a twinaxial cable. The 
transfer of information over the cable interface is 
called local operations. 


The 4224 is an intelligent printer data stream (IPDS) 
printer. Refer to the /BM 4224 Printer Product and 
Programming Description, GC31-2551, for more 
details. 


Functional Characteristics of the 5251 
Models 2 and 12 and 5294 in Remote 
Operations 


The 5251 Models 2 and 12 and the 5294 (controllers) 
consist of a microprocessor and a shared storage 
area. The storage areas temporarily hold data or 
commands as they pass between the addressed 
device and the host system. 


The 5251 Models 2 and 12 and the 5294 micro- 
processors (1) determine the type of commands the 
host system has sent, (2) translate these commands 
into microcoded transmission commands that can be 
sent to the attached device, and (3) send these micro- 
coded commands in the acceptable transmission pro- 
tocol to the addressed work station. 


In addition to routing commands, the micro- 
processors route data and status information 


between the 5250 work stations and the host system. 
The controller, attached display stations, and 
attached printers all contain storage areas that hold 
commands and information until they can be either 
processed or routed to the intended receiver. 


Overview of 5250 Implementation of SDLC 


The Synchronous Data Link Control (SDLC) protocol 
consists of (1) an established format for sending link- 
level commands and data, (2) a pattern for initiating a 
transfer link between the host system and the con- 
troller, and (3) a format for transmitting SNA proto- 
cols. The format SDLC uses to convey information is 
the SDLC frame. See Figure 1-1. An SDLC frame is a 
bit pattern that contains flags for synchronization, 
both SDLC link-level control information and SNA 
data information. The SDLC frame that contains the 
SNA RuUs is called the | (information) frame; this is 
the only SDLC frame type that contains the 5250 user 
data. See the index entry frames (SDLC) for details 
about the frame contents and types. 


Typically, SDLC’s requirements are set and remain 
unaltered by the user. The SDLC XID response can 
be an exception to this general usage; therefore, spe- 
cific details about the contents of the XID response 
are given in the index entry SDLC, commands and 
responses. In addition, the other SDLC commands 
are briefly described to help an interested user deter- 
mine or locate the causes of SDLC-generated errors. 


The 5250 implementation of SDLC is half-duplex 
(HDX). This means that the 5251 Model 2 or 12 can 
be in either the receive state or the transmit state, 
but they cannot be in both simultaneously. 


The 5294 Control Unit uses SNA full duplex (FDX) if it 


has the X.25 feature installed. Figure 1-1 shows the 
SNA relationship. 
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Flag 8 bits 

Station address 8 bits 

Control field 8 bits 

Information field variable 
Transmission header 2 bytes 
Request/response header 3 bytes 
Request/response unit 0-256 bytes 
Frame check sequence 16 bits 

Flag 8 bits 


Overview of the 5250 Implementation of the 5250 devices is the SNA support that the 5250 


SNA system implements. See Figure 1-2. The 5250 uses 
a subset of SNA; the following text describes the 
Systems Network Architecture (SNA) is a system of implementation of this SNA subset. 


hierarchical rules commonly called protocols. These 
rules define such things as the data stream format 
(RUs) and the process for routing data (data flow 
control). The user’s primary concern in programming 


“aCe 
Weld Ot, 


Local Operations 
Transmission Commands and Responses 


Information from the host 

is translated into information 
that can be sent to the 
attached devices. 


Data Streams 
I 
Control Information Returned Data 


Remote Operations 


SDLC, HDLC Commands Aid Codes 
I 
SNA Commands Responses (SDLC, HDLC, and SNA) 


Figure 1-2. Overview of Data Flow for the 5250 Information Display System 
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Description of General SNA Terms Used in This 
Manual 


When in operation, terminals are normally connected 
to two independent control points. These are a 
supervisory control point and an application user 
control point. Logical unit (LU) types 4 and 7 provide 
two independent sessions, one for each control point. 
The supervisory control is accomplished on the 
supervisory services-logical unit (SS-LU) session. 
Because each control point has different require- 
ments, the sessions have different protocols. The 
LU-LU session controls the entire display screen or 
printer page. The SS-LU session has limited control 
over the devices, has one display line (called the 
system message line), and has no print capability. 
The supervisory control point may control application 
programs using these terminals. 


The supervisory services in the host system may also 
communicate with the controller on another session 
with the physical unit. This session protocol allows 
only maintenance information to be passed between 
the controller and the host system. 


A session is the logical connection that exists 
between two control points. To establish these ses- 
sions two different commands are used, Activate 
Logical Unit (Actlu) and Bind. The supervisory 
services-physical unit (SS-PU) session is assumed 
automatically whenever communication at the data 
link level or X.25 packet level is established. The 
SS-LU session is established after the SNA Actlu 
command is positively responded to; the LU-LU 
session is established after the SNA Bind command 
is positively responded to. 


A request/response unit (RU) is an SNA data area. It 
is a maximum of 256 bytes long. The RUs contain (1) 
all the information (commands, parameters, and 
associated data) required by the controller to make 
the LUs perform a user-specified (SS or application 
program) function, (2) all data returned to the host 
system in response to a command, and (3) responses 
both from the controller (initiated by either the con- 
troller or the LU) and from the host system. RUs can 
be linked in multiple SDLC | frames such that multiple 
RUs can be sent. This is called chaining; see the 
index entry chaining. When chaining is used, the rel- 
ative position of each RU in the chain must be indi- 
cated to the host system; the heading “Protocols and 
Synchronization for 5250 Implementation of SNA” in 
this section describes this subject. In addition, the 


rate at which the receiver can accept SNA RUs can ) 
also be adjusted. This is called pacing. See the index 
entry pacing for details. 


Each RU is prefixed by header information defining 
its type. Together, the header information and the 
RU form the path information unit (PIU). The headers 
are the TH and RH parts of the frames. TH stands for 
transmission header and RH stands for 
request/response header. The TH and RH define the 
session type and RU characteristics; the RU contains 
all LU information such as the commands, data, and 
responses required. 


The types of RU flow vary. The RUs can be normal or 
expedited and can consist of (1) sessidn control (SC), 
(2) data flow control (DFC), or (3) function manage- 
ment data (FMD) RUs. These RUs flow on either the 
SS-LU or LU-LU session. There are different protocol 
restrictions for each type of RU. For example, LU 
data streams are always in the normal FMD flow. 
See the heading “Protocols and Synchronization for 
5250 Implementation of SNA” in this section. 


In the 5250 implementation of SNA, the two SNA 
session partners are the host system and the con- J 
troller. The host system controls the LUs (5250 work ) 
stations) by sending commands and data to each LU. 
These commands and data are embedded in the SNA 
RUs. The sender determines the type of response 
requested by coding bits 0 and 3 of byte 1 of the RH. 
The sender specifies RQE or RQD. 


Request exception (RQE) asks for a response only if 
the RU is unacceptable; that is a negative response. 
A negative response RU identifies the type of RUs 
and carries information identifying the error condi- 
tion. 


The other type of response request is request definite 
(RQD). RQD requests that the receiving partner 
always respond to the RU that has been sent. If the 
RU is without error, the receiver responds positively; 
this response may consist of returning the SNA 
command code that was sent. If an error is encount- 
ered in the RU, the receiving partner returns a nega- 
tive response. 
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Addressing in the 5250 System 


The three addresses that the 5250 system uses and 
that the system programmer must determine (or 
default to) are the station address, the work station 
address, and the local session identifier (LSID). Note 
that the LSID includes the local station address. 
Figure 1-3 shows the relationships of the addresses. 
For detailed information on configuring the 5250, see 
the /BM 5250 Planning and Site Preparation Guide. 


Legend: 


Local Station Address (Unit Address) 
This is six bits of the LSID. The 
system programmer determines 
this when he configures the 
system. These bits identify 
either the keyboard/display of 
the 5251 Models 2 or 12, ora 
specific work station attached 
to the 5251 Models 2 and 12 or the 5294. 
For details, see the index entry /ocal 
Station address. 


LSID 
This is eight bits of the TH. The 
system programmer determines this 
by determining the local station 
address, which is six bits, and the 
session type identifier, which is 
two bits. See the index entries LS/D 
and sessions. 


Controller Station Address 
The host system uses this to identify 
the controller. The controller scans 
the A part of the SDLC frame for its 
controller station address. See the 
index entries frames and station 
address. 


Work Station Address 
This is the address that is set with the 
switches or from a display on the work 
station. The controller uses this to 
identify a specific device attached to it. 
See the index entry work station address. 
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Work Station Address 
Rocker Switches 


Work Station Address Rocker Switches 


Fill Parity Work Station Commands Sync 
Bits Bit Address and Data Bit 


Controller Station Address 


SDLC Frame 
Flag | Address | Control ee ee RU 

eamcller “TSI, 
Station rh \ 
Address i \ 

Ff \ 

/ ‘ 

, ‘ 

‘ 


LSID 


/ 


ee 
Local Station Address 
(unit address) 


Session Identifier 


Figure 1-3. Relationship of Addresses 
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Controller Station Address 


The station address field is 8 bits long; it is the A part 
of the SDLC frame. For the controller, this field 
carries the controller station address. See the index 
entry frames. The programmer uses this address to 
identify the controller that he wants to communicate 
with. The programmer determines the address and 


then uses the addresses during system configuration. 


See Figure 1-3. 


Work Station Address 


The work station address is 3 bits long. It is in the 
transmission frame. The controller uses it to address 
the devices attached via the twinaxial interface. 
Cable Thru has a direct effect on the work station 
address: 


e If Cable Thru is not installed (or used), the work 
station address is 000. Without address switches, 
the system automatically defaults to 000 for the 
5251 Models 1 or 11, the 5225, and the 5256, and 
to 000 and 001 for the 5252. 


e If Cable Thru is installed (Cable Thru is standard 
on the 5291, 5292, 3179, 3180, 3196, 4210, 4214, 
4224, 5219, 5224, and 5262), assign appropriate 
work station addresses to all devices. See the 
IBM 5250 Planning and Site Preparation Guide, 
GA21-9337, for information about these 
addresses. 


Note: There is only one set of these switches for 
each 5252. 


Make the work station address assignments by 
setting the work station address switches (or by 
setting the address from the keyboard); you do not 
directly use the work station address to communicate 
with the specific device. You address a device 
attached via a cluster feature through the local 
station address bits (LSID). Figure 1-4 illustrates a 
sample configuration with work station addresses 
assigned using a 5251 Model 2 or Model 12. 


Figure 1-5 illustrates a sample configuration using 
the 5294 Control Unit. This example is described in 
detail in the /BM 5250 Planning and Site Preparation 
Guide, GA21-9337. 


The 4224 work station address is selectable from the 


operator’s panel. For more information, see the /BM 
4224 Printer Operating Instructions, GC31-2546. 
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The terminator switch 
is set to 1. (Cable Thru 
feature is standard on 
this work station.) 


Commands/Responses 


: linge oe Terminator 
Device : ; 
e switch is set to 2, 
A 


15263748 


SSS 


ee 
CF1 Port oo 
Switch = 10 
CF2 Port ee 
SS Terminator 


switch is set to 2, 
SNA/SDLC 


Commands 


The terminator switch 
is set to 1. (Cable Thru 
feature is standard on 
this work station.) 


Legend: 
Cluster Feature (CF1) 


No Cable Thru feature is installed. A 5252 Dual Display Station is attached to port 1. A 5225 Printer and a 5291 
Display Station are attached to ports 2 and 3. 


Dual Cluster Feature (CF1 and CF2) 
The Cable Thru feature is installed and being used on three of the devices attached to port 5 of CF2. A 5256 
Printer, a 5251 Model II Display Station, a 5224 Printer, and a 5291 Display Station are attached to port 5 using 


the Cable Thru feature. A unique work station address must be assigned to each work station. If the last device 
does not have the Cable Thru feature installed, its work station address defaults to 000. 


Figure 1-4. Sample Configuration of the 5250 Information Display System with 5251 Model 12 Addressing J 
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Figure 1-5. Sample Configuration of the 5250 Information Display System with a 5294 Control Unit 
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LSID and Local Station Address 


The local station address is a 6-bit part of the LSID, 
which is in TH byte 1 (in the SNA header). See the 
index entry TH. The 6 bits identify the specific device 
(LU) that the host system wants to address. The 
remaining 2 bits of TH byte 1 are session flow infor- 
mation and indicate which SNA session is used in 
communicating with the LU. 


Note: LSID = 0 (hex 00) indicates an SS-PU session, 
which is used only for maintenance services by 5251 
Models 2 and 12 and the 5294. 


You must provide both the local station address and 
the session flow information for the LSID. See the 
index entry sessions for information about the ses- 
sions and session flow bits. 


The keyboard/display of the 5251 Models 2 and 12 
always has the local station address 000000. All 
other local station addresses are determined by the 
programmer. Use the local station address specified 
for the device as the 6-bit address part of the LSID. 
Determine the session type and code the remaining 2 
bits accordingly. 


Error Handling in the 5250 
System 


The SNA protocol determines the error-handling 
process used by the 5250 system; for operator errors, 
this association is indirect as described in the fol- 
lowing text. The type of error and the point of proc- 
essing at which it occurs in the RU chain determine 
the resulting error code (SNA command or negative 
response). 


The error codes identify both the device in which the 
error is occurring and the reference to the condition 
causing the error. These error codes are found in the 
Signal commands, negative responses, and error log. 
The format for the error codes is: 


XXYY 


XX = device type: 
00 = controller 
01 display 
02 = printer 


YY = error identifier 


See the index entries for these topics to find detailed 
information. 


The basic categories of errors within the 5250 system 
are: (1) operator-associated errors, (2) programming 
(parameter) errors, (3) SNA protocol errors, and (4) 
hardware errors. Figures 1-6 and 1-7 illustrate the 
resulting SNA commands and responses and error 
codes implemented by these error types. As you can 
see by looking at Figures 1-6 and 1-7, SNA uses the 
SNA Signal, Rshutd, Lustat, and Cancel commands 
and the negative response to identify errors in the 
programming and hardware areas of the 5250 
system. 
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Errors 


Programmer 
Operator (parameter) SNA Protocol Hardware 
Error Codes Error Codes Error Codes Error Codes 


Type of Error Code Result 

Operator The error message provided by the host is accessed 
by the operator using the Help key, on the display 
station, to generate a Signal command. 


Some operator error codes are logged. 


Programmer (parameter) Lustat or negative response is sent to the host. 


Error 
Hardware See Figure 1-7. 
SNA Protocol No operator intervention required. 


Figure 1-6. Types of Errors and the Results of These Errors 
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Operator Errors 


The 5250 uses operator error codes that appear on 
the display and that are returned to the host system 
in the Signal command (when the operator uses the 
Help key in an error state) to identify operator errors. 
The operator accesses descriptive information about 
the error condition by using the Help key in the error 
state; the information obtained by using the Help key 
is the responsibility of the host programmer. One 
way to provide this information to the operator is via 
the Write Error Code command. If the host system 
does not provide additional information, the original 
error code remains and the work station enters the 
posthelp error state. The index entries operator error 
codes, signal command, command and response 
code, help key, and write error code command refer 
to text containing specific information about these 
subjects. The index entry error states refers to the 
descriptions of the conditions that exist while the 
device is in an error state. 


FMD Programming Errors 


FMD programming errors are the result of incorrect 
or unacceptable coding being used by the sending 
partner. For programming errors, if the LU isina 
receive state when the error occurs, the controller 
sends the host system a negative response. If the LU 
is ina send chain state (LU has CD) and is sending 
when the error occurs, the controller sends the host 
system a Cancel command and a Lustat command. 
See index entries negative responses and /ustat 
command for additional information. 


SNA Protocol Errors 


If an SNA protocol error is detected, a negative 
response is generated immediately, regardless of the 
state of the LU. No Cancel, Rshutd, or Lustat 
command will be sent. 


Hardware Errors 


The hardware errors are those errors detected in the 
controller, display station, and printer physical 
devices. Figure 1-7 shows the paths the hardware 
error conditions take. 


If a hardware error is detected when the controller is 
in a receive chain state, it sends a negative 
response, a Rshutd command, and a Lustat command 
to the host system. The negative response identifies 
the error condition; the Rshutd command requests 
the host system to terminate the session and send an 
Unbind command; and the Lustat reports the LU as 
unavailable to the SS. If the LU is not in a chain 
state, it sends the Rshutd and Lustat commands. 
These commands request the host system to termi- 
nate the session and report the unavailability of the 
LU respectively. See index entries negative 
responses, rshutd command, and lustat command for 
details. 


The handling of printer hardware errors is the most 
complex of all the error conditions. Figure 1-7 shows 
the paths the printer hardware error conditions take. 
The method used for identifying the printer hardware 
errors depends on the condition of the error; in other 
words, it depends on whether or not the error condi- 
tion can be corrected by the operator. In addition, 
the state of RU chaining determines the resulting 
SNA code sent by the controller to the host system to 
identify the error. 


When an operator-correctable error occurs in the 
printer (such as a forms jam), the controiler sends 
the host system a Signal command. If the operator 
successfully corrects the error, the controller sends 
the host system another Signal command indicating 
that the error condition no longer exists. See the 
index entry signal command, command and response 
code. If, however, the operator cannot correct the 
error, the operator positions the printer Status switch 
to Cancel and the controller sends the host system a 
negative response. This indicates that the error has 
not been corrected and that other action is required. 
The host programmer determines what must be done 
when a negative response is received. See the index 
entries CD, chaining, rshutd command, lustat 
command, negative responses, and cancel command. 


In addition to identifying errors, the controller imple- 
ments an error log buffer in the controller. This error 
log holds error information about selected error con- 
ditions. The user obtains the log in one of two ways: 
(1) the user requests the log contents using the SNA 
Reqms command, or (2) the log contents are auto- 
matically sent when a log overflow condition exists 
(Recfms command). See index entries reqms 
command, recfms command, and errors, error log. 
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Figure 1-7. Hardware Errors and the Responses Generated by These Errors 
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SNA Session Flow 


The three types of sessions that allow RUs containing 
user-defined commands and responses (to varying 
extents) are SS-PU, SS-LU, and LU-LU. See 

Figure 1-8. 


The host system-to-controller commands (such as 
Reqms) are used in the SS-PU sessions; the host 
system-to-LU commands (such as Actlu) are used in 
the SS to LU sessions; and the application 
program-to-LU commands (such as Write to Display) 
are used in the LU-LU sessions. The controller-to-LU 
commands are the transmission commands. The TH 
and RH determine the type of session and the RU 
type for the RU data flow. Figure 1-9 shows which 
commands are valid on each session and whether 
those commands are normal or expedited flow. The 
SS-PU session is always considered active whenever 
communications at the data link or X.25 packet level 
are established. 


Only one session is available for user data. The user 
application program data stream flows only on the LU 
to LU session. Certain RUs may contain SNA com- 
mands (session control or data flow control com- 
mands) that allow the host system to establish, 
control, and terminate sessions with the addressed 
LU. 


The type of LU, display or printer, that is addressed 
by the host system determines what the data stream 
must include. For example, the printer data stream 
contains only control characters and data. The 
control characters are mixed with the data; they 
determine the format of the lines and specify a write 
operation. On the other hand, the display station LUs 
are both input and output devices. The host system 
can issue both Read and Write commands to them. 
Because the screen is a field-formatted input/output 
device, it also requires formatting controls such as 
control characters and orders to be intermixed with 
data. 
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Figure 1-8. Types of Session Flow 
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Figure 1-9. Allowable Sessions and RU Types for Commands and Data Sent to or from the Controller 
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SNA Session Control and Data Flow 


Before any data stream commands can be sent to the 
addressed LU, a session must be established 
between the host system and the addressed LU. This 
is accomplished by the session control (Actlu and 
Bind) commands. A detailed description follows 
Figures 1-10, 1-11, and 1-12. 


Note: See “Protocols and Synchronization for 5250 
Implementation of SNA” in this section for an 
example of session flow control. Some of the normal 
activities that occur between the host system and LU 
are: 

e Session established between the SS and the LU 


e User program established to LU session-binding 


e Commands sent by user to the LU (Read/Write 
Display or Write Printer) 


e Information sent from LU to the host system 


e Error history documentation for maintenance pur- 
poses 


e Unit tests sent to a selected work station. 
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(V)Actlu and Response 
(establishes the SS-LU session) 
2) Bind and Response 
(establishes the LU-LU session) 


Figure 1-10. Establishing Sessions 
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Figure 1-11. 
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Device Commands/Responses 


A) Unbind (terminates the LU-LU session) 


2) Dactlu (terminates the SS-LU session) 


Figure 1-12. Terminating Sessions 
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Establishing a Session Signing On 

For the 5251 Models 2 and 12, use either the SS-LU or 
LU-LU session to sign on. For the 5294, use the 
LU-LU only. The two session flow types are illus- 


The terminal cannot initiate a session. The host 
system must do this. Prior to the host system initi- 
ating a session, a typical display station operation 


might look like this: 


1. 


Power is on. 


program in the host system and the requested 
5250 device. 


trated here: 


SS-LU Flow Sign On 


2. The keyboard is unlocked and in free keying 
Actlu 
mode. When the operator presses a key that ie LU 
requires host system action, an operator error oe 
occurs. The operator presses the Error Reset 
: Host LU 
key and the keyboard returns to the free keying ; , 
. (SS-LU session established) 
mode. See the index entries signal keys and aid- 
ine ean aaa Sign-On Dat (SS-LU FM fw 
; Host LU 
erate ; +rsp 
3. The host system initiates the SS-LU session by Host LU 
sending an Actiu. The LU sends a positive 
response back to the host, indicating the | LU-LU Flow Sign On 
requested device’s status and an SS-LU session 
is established. Aoi 
Host LU 
Establishing a User Program to LU +rsp 
Flow-Binding Host LU 
Bind 
Now that an SS-LU session has been established, the Host LU 
host initiates an LU-LU session: +rsp 
Host LU 
1. The host or user sends a Bind command to the (LU-LU session established) 
requested device to establish an LU-LU session Sign-On Data (LU-LU FM flow) 
between the user’s application program and the Formatted Data 
5250 device. Host LU 
+rsp 
2. The device (LU) responds positively with session Host LU 
and device parameters in the bind response RU. 
See the index entry bind command, responses for 
details. 
3. An LU-LU session is established between a 
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User-LU Communication 
Write Commands (User to LU) 


The user communicates with the LU by performing 
the following: 


1. First, the host sends an RU. Typically, the RU 
begins with an escape character, followed by a 
Clear Unit command, followed by another escape 
character. 


2. Then, in the same RU, the host programmer 
sends the next command, which is a Write to 
Display (WTD) command. See the index entry 
write to display command for details. This builds 
the format table, which determines the field char- 
acteristics of the display. 


3. The host programmer sends more information 
and commands (such as the Read commands), 
and when the end of the chain is reached (LIC), 
the LU responds as directed by the host system 
(either RQE or RQD). See “Protocols and Syn- 
chronization for 5250 Implementation of SNA” in 
this section for additional information about LIC, 
RQE, and RQD. 


Read Commands (LU to User) 


The user receives information from the LU by per- 
forming the following: 


1. The operator begins entering data when the key- 
board is unlocked after the Write to Display 
command has been processed. This results in: 


a. The keystrokes being translated into EBCDIC 


b. The translated keystrokes being put into a 
buffer and held until the LU is given authority 
by the host system (in the CD bit and Read 
command) to send the information, and the 
operator presses an aid-generating key 


c. Cursor movement. 


2. The operator presses the Enter/Rec Adv key. If 
the host system has sent a Read command and 
the CD bit, SNA puts the information that is in the 
buffer in one or more RUs and sends it to the host 
system (for the user’s program) in the normal 
flow. 


Printer Write Operations 


The user writes to the printer by coding the appro- 
priate control characters (see the index entry control 
characters, printer) into the data stream where the 
user wants the control to occur. When the printer 
receives the data stream, it prints the information as 
formatted. 


Maintaining an Error Log 


The controller contains a local error log which is sent 
to the host system on the SS-PU SNA session when- 
ever the buffer containing the log is almost over- 
flowing. In addition, the SS can request this log by 
issuing a Reqms command. See the index entry 
reqms command for details. See the index entry 
errors, error log for a description of the contents of 
this log. 


Testing a Unit Device 
To request a test operation, the operator: 
1. Presses and releases the Cmd key. 


2. Presses and releases the Character Backspace 
( «——) key on the typewriter-like keyboard or the 
rightmost blank key on the top row of the data 
entry keyboard. As a result, the controller sends 
an SNA command called Reqtest on the SS-LU 
flow to the SS. The SS can reply with either test 
routines or menus to select tests; this is a user- 
defined or system-defined function. 


Protocols and Synchronization 
for 5250 Implementation of 
SNA 


The controller uses the SNA protocol in communi- 
cating with the host system. This protocol consists of 
(1) formats and sequences to manage multiple ses- 
sions and (2) the data flowing with these sessions. 
The following text describes this protocol. A 
description of specific SNA terms precedes the pro- 
tocol description because an understanding of the 
definitions is a prerequisite to an understanding of 
the text and illustrations that follow. 
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Terminology Used in Describing the SNA 
Protocols 


The following definitions are some of the fields 
involved in the SNA flow. For a complete description 
of the Request/Response header, see the index entry 
RH. 


CD: Change of direction; bit 2, byte 2 of the RH. It 
reverses the direction of flow when examined on LIC. 
See the index entries CD and RH. 


Chain: A unit of error recovery composed of RUs. 
See the index entry chaining. 


FIC: First in chain; this refers to the first RU in a 
chain of RUs. See the following chart. 


MIC: Middle in chain; this refers to the RUs within a 
chain of RUs. See the following chart. 


LIC: Last in chain; this refers to the last RU ina 
chain. See the following chart. 


OIC: Only in chain; this refers to one RU in a chain. 
See the following chart. 


RH - Byte O 
Position of the RU 
in the Chain Bit 6 Bit 7 
FIC 1 0 
MIC 0 0 
LIC 0 1 
OIC 1 1 


FDX: FDX stands for full duplex. Within the SNA 
structure, this means that both session partners can 
be in send state simultaneously. However, because 
the controller implementation of SDLC allows only 
half duplex, a buffer is required to hold information 
sent by one session partner while the other session 
partner is transmitting. This is how a full duplex 
SS-LU flow looks: 


RQD, OIC 
Host LU(A) 
ROD, OIC 
Host LU(A) 
+rsp 
Host LU(A) 
+rsp 
Host LU(A) 


Although both stations are in SNA send state simul- 
taneously, only one SDLC transmission can occur at 
a time because of the half-duplex restrictions of the 
SDLC communications lines. Therefore, the extra 
information must be held. 


Flow: Flow is the SNA path routing the RU type 
takes. The two types of flow are normal and expe- 
dited. See Figures 1-9 and 1-13. 


Formatted: Formatted refers to the SNA-defined 
format required for an RU. To the programmer, this 
means that bit 4 of byte 0 in the RH is on. See 
Figure 1-13 to determine when formatting occurs. 


HDX: Stands for half duplex. Within the SNA struc- 
ture, it means that only one session partner can be 
sending ata time. The sending session partner must 
include a CD bit in the flow in order to give authority 
to the remaining session partner to send information. 
Without CD, the other session partner cannot send 
information. The CD is required only to send an RQ 
(RQE and RQD) and not to send a response (rsp). 
This is an FM example of half-duplex flow: 


ROD, CD, OIC 
Host LU 
+rsp 
Host <——<—<££ @——_—_——— LU 
FIC, ROE 
Host LU 
MIC, ROE 
Host LU 
LIC, ROE, CD 
Host CLL 
OIC, ROD 
Host ——_—— Li 
+rsp 
Host <—<£_ —__—————————— eee Sw 
ROE, CD 


Host ——£- —— LU 


OIC, Data, CD, ROE 
LU 


Host 
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RU Types: The RU types used by the 5250 system are 
function management data (FMD), data flow control 
(DFC), and session control (SC). Figure 1-13 shows 
the characteristics and contents of these. The data 
stream for the LUs is in the FMD LU-LU normal flow. 
Bits 1 and 2 of byte 0 in the RH part of the SNA 
header contain the code for the various RU types. 
See the index entry RH. 


-rsp: Negative response. Allows the controller or 
host system to report to its session partner that an 
invalid condition exists. See the index entry negative 
responses for details about the use of the negative 
response with the 5250 devices. 


+rsp: Positive response. Allows the controller or 
host system to report favorably to its session partner 
in response to a command (such as the Bind 
response code). See the index entry SNA, com- 
mands for details. 


RU Type prc 
SS-LU LU-LU SS-LU_|{LU-LU [| SS-LU[LU-LU 


Normal Normal Normal Expedited | Expedited 
Expedited 
Mode FDX FDX HDX FDX FDX HDX Not Not 
FDX applicable applicable 


Chain and 1 RU < 128 |9 bytes < 256 bytes| < 256 5 bytes 5 bytes 3 bytes 26 bytes 
RU bytes OIC |OIC Normal bytes OIC OIC OIC OIC 
Restrictions | (Note) 

CD 


Response RQD no RQD no RQE-CD RQD no RQD no RQD no |RQDno 
CD CD RQD-CD CD 
and no CD 


and CD CD CD 
Message in | Reaqtest LU data Reqms Lustat 
EBCDIC stream Recfms 
characters 
from ortoa 
display 
station or 
system 
request data 


Unformatted] Formatted | Unformatted| Formatted | Formatted | Formatted Formatted 
Formatted 


Note: The controller truncates data allowed on the display to 78 bytes. 


o 
O 


@) 
Oo 


Actlu Bind 
Dactlu Unbind 


Contents 


Figure 1-13. SNA Protocols Used by the 5250 Information Display System 
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Display Protocols 


The following topics show what happens when the 
user LU sends RUs and the addressed display station 
LU executes them. 


Log On 
ROD (see note), OIC 
Host LU 
Entry 
+rsp 
Host LU 


The programmer determines the sign-on sequence. 
See the heading Signing On earlier in this section. 


Note: A response required (RQD) is required only on 
the SS-LU flow. 


Write Command Flow 


FIC, ROE 

Host LU 
MIC, RQE 

Host LU 
LIC, ROD 

Host LU 

+rsp 
Host LU 


Add more writes (if needed) in the above format. 


Read Commands 


OIC, CD, ROE 
Host LU 
FIC, ROE 
Host LU 
MIC, ROE 
Host LU 
LIC, RQE, CD 
Host LU 


Operator Uses the Attn Key 


Note: The keyboard can either be locked or 
unlocked. 


OIC (Signal), ROD 


+rsp (to Signal) 
(expedited flow) 
LU 


Host 


For a description of the Signal command, see the 
index entries signal command, command and 
response code. 
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Printer Protocols 


The following topics show acceptable printer proto- 
cols. 


Note: CD should not be sent to the printer; if it is 
sent, the printer returns a Lustat of 00 02 00 00 to the 
host system. See the index entry /ustat command for 
details. 


Writing to the Printer 


FIC, ROE 
Host LU 
MIC, ROE 
Host LU 
LIC, ROD 
Host LU 
+rsp 
Host LU 
A Correctable Error Occurs 
FIC, ROE 
Host LU 
Signal sent as the result of an error 
such as end of forms in the printer. 
Host LU 


+rsp to Signal 
Host. ——_<—— Li 
Signal indicating correction of 
condition causing the error. 


Host LU 
+rsp to Signal 
Host LU 
MIC, ROE (The chain continues until 
the termination of normal processing.) 
Host LU 


For a description of the Signal command, see the 
index entries signal command, command and 
response code. 


A Noncorrectable Error 


FIC, ROE 


LU 
MIC, RQE 


LU 
-rsp (caused by an error 
condition in the printer). 
Host <A  ———eeeeeseseer 
Rshutd (sent on the LU-LU flow) 
Host <A Lr 
+rsp to Rshutd 
Host 2A, OLY 
Lustat on SS-LU flow indicating 
device not available status. 
Host =< Lu 
+rsp to Lustat 
Host =——____________________ Ly 
Unbind 
Host ——_— AAA Le 


+rsp to Unbind 
Host ——<£—__— ui Li 


The host system determines whether to unbind (use 
the Unbind command) or deactivate (use the Dactlu 
command). See the index entries dactlu command 

and unbind command for details. 


Note: By using the Unbind command, the 5251 
Models 2 or 12 will notify the host system when the 
device is available again by issuing another Lustat. If 
the host system issues a Dactlu command, no Lustat 
can be issued. 


For descriptions of Lustat, Rshutd, and Unbind, see 
the index entries /ustat command, rshutd command, 
and unbind command. 
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The Host System Terminates a Chain 


FIC, ROE 

Host ——-—-————— ee —CO#LU 
MIC, ROE 

Host LU 

Cancel 
Host LU 
+rsp to Cancel 
Host LU 


Note: For details about the Cancel command, see the 
index entry cancel command. 


The following topics illustrate communications 
between the host system and the controller involving 
error logging. 


Error Log Overflow Condition (Unsolicited) 


Recfms and Logged Data 


Host Controller 


+rsp to Recfms 


Host Controller 


Requested Log Data (Solicited) 


Host —— > Controller 
+rsp to Reqms 
Host <—@_——_———__ Controller 
Recfms (logged data) 
Host —<—@ —@£ —————_—____—_—————_ Coon troller 


+rsp to Recfms 


Host ————_—__—_—_———_—_—___—-. Controller 


For a description of Reqms and Recfms, see the 
index entries reqms command and recfms command. 
For a description of the logged errors, see the index 
entry errors, error log. 


Requesting Status from an IPDS Printer 
Multiple Status Commands 


The IBM 4224 responds to two different status com- 
mands: Read Multiple Status and Reset Multiple 
Status. 


Read Multiple Status 


ESC Escape character (hex 04), 

required to begin each RU chain. 
470100 A hex value for Read Multiple 
Status command. 


The Read Multiple Status command generates an 
IPDS Acknowledge Reply (ACK) response from the 
4224. The reply contains 256 bytes of status informa- 
tion. The printer uses the ACK to return device 
status, sense information, and any additionally 
requested information back to the host application 
program. Refer to the /BM 4224 Printer Product and 
Programming Description manual, GC31-2551, for 
more details concerning the Acknowledge Reply 
command. 


Printer Protocol for a Read Multiple Status Command 


OIC RU + CD 


(Read Multiple Status Command) 
Hosth 2 Li 
OIC RU + CD 


eee (256 Bytes of Status) te 


+ 
Lest rsp to OIC Ly 


Note: The Read Multiple Status command must be 
sent in an OIC RU with CD. 
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Reset Multiple Status 


ESC Escape character (hex 04), 

required to begin each RU chain. 
470000 A hex value for the Reset Multiple 
Status command. 


The Reset Multiple Status command is processed the 
same way as a Read Multiple Status command, but 


does not generate any returned information. 


Printer Protocol for a Reset Multiple Status Command 


OIC RU + CD 

beet (Reset Multiple Status Command) LU 
OIC RU + CD 

CO —— ae LU 


das + rsp to OIC LU 


Note: The Reset Multiple Status command must be 
sent in an OIC RU with CD. 


Display Data Stream Example 


This topic consists of examples showing the coding 
required to write to an alphanumeric and graphics 
display, read from a display, and respond to an error 
condition in the display. In the examples, the comma 
(,) is used as a byte separator. Single quotes delin- 
eate a character string. Within the character string, 
each character represents one byte of EBCDIC code. 
The row and column parameters for the Set Buffer 
Address (SBA) and Insert Cursor (IC) orders and the 
length parameter for the Start of Field (SF) order are 
given in decimal in this example. In an actual pro- 
gramming environment, these parameters must be in 
hexadecimal notation. For example, SBA, 10,27 
should appear as hex 110A1B in actual code. 


No attempt has been made to represent the 
SDLC/SNA headers and flags; only the contents of the 
SNA RUs are given. 


Note: In the following illustrations, @ represents the 
screen attributes. These attributes are not normally 
displayed; they are shown in these illustrations to 
help you understand their location within the dis- 
plays. If you are operating 5251 Models 1, 2, 11, or 
12, or a 5252 dual display station, and want to see the 
screen attributes, display them by positioning the 
Status switch to Test. To display attributes on other 
display stations, refer to the appropriate operator’s 
guide for the display device. 


Writing to a Display 


First, a display must initially be built from the infor- 
mation provided in the Write to Display command; 
next, the information must be updated to reflect 
changes made by the operator. 
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9 


C 


Building an Alphanumeric Display 


ESC, CU, ESC, WTD, CC, 


ESC 


Escape character (hex 04), required to begin 
each RU chain. 


CU 


Clear Unit command (hex 40), recommended to 
ensure the integrity of the data to be written to 
the display. This command clears the display 
and format table of all information. See the index 
entry clear unit command. 


ESC 


Escape character, required to link commands 
within an RU chain. 


WTD 


Write to Display command (hex 11), required to 
write any information to the display. This 
command has many associated parameters. As 
used here, these consist of the SBA and SF 
orders, control characters, screen attributes, 
display control words and field control words. 
See the index entry write to display command for 
details. 


CC 


Two-byte control character associated with the 
Write to Display (WTD) command. In this case, 
the CC bytes are hex 00 and 08. In this example, 
only the second byte is functional; it unlocks the 
keyboard. See the index entry contro! charac- 
ters, display for details. 


SBA 


Set Buffer Address order (hex 11), required to 
locate the beginning position of the data to be 
written on the display. The two numbers that 
follow the order (which in this example are 01 
and 15) are the row and column address that 
define the beginning data position. See the index 
entry SBA order for details. 


@ 


Screen attribute that determines how the field is 
displayed. 


‘ACCOUNTS RECEIVABLE -- UPDATE MODE’ 
Data to be written to the field in the position 
defined by the preceding SBA order. The charac- 


teristics of this data on the display have been 
defined by the screen attribute. 
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SBA 


Set Buffer Address order (hex 11). This order 
defines the position of the next data field to be 
written as row 3 and column 1. 


SF 


Start of Field order (hex 1D). This order defines 
the beginning position of the first operator-entry 
field. The parameters following the order locate 
the field and define its characteristics. The 
parameters are FFW, @, and length. The field 
can contain data; in this event, the data is alter- 
able. See the index entry SF order for details. 


FFW 


Field Format Word (2 bytes). In this example, the 
field is a numeric-only (hex 4300) field with no 
other restrictions. See the index entries fields 
and field format word for details. 


Screen attribute that determines how the field is 
displayed. 


21 


Field Length. This parameter consists of 2 bytes. 
It specifies the length of the field. In this 
example, 21 locations are required, so hex 0015 
will appear in the RU. 


Note: The controller automatically writes a normal 
attribute (hex 20) at the end of the field. 


In the same manner, build the name, address, city, 
state, and zip fields. See Figure 1-14. 


SBA,09,01,@,’--DATE--- 
--LEDGER XREF-- 


--CODE-- 
--DEBIT-- 


--CREDIT--’,@ 


This coding writes the data headings on a line begin- 
ning at row 9 and column 2. The screen attributes 
will be on row 9, column 1. The screen attributes that 
the user defines determine the characteristics of the 
line. Remember, if the screen attributes are other 
than normal, an ending screen attribute should be 
specified to reset all fields that follow to normal 
display. 


SBA, 10,1,SF,FFW*,@,8,SBA, 10, 18,SF,FFW",@,2, 
SBA, 10,26,SF,FFW*,@,10,SBA, 10,45,SF,FFW**,@,7, 


SBA, 10,58,SF,FFW**,@,7,. . ..(This coding scheme 
continues for all 24 rows.) 


Note: The asterisks are explained in the following 
text. 


Some of the entry fields are not only numeric-only but 
also mandatory entry (*) and some are right-adjust 
fields with blank fill (**). This field entry control is 
accomplished with the FFW. For numeric-only fields 
with mandatory entry, the FFW = hex 4308. For 
numeric fields with right adjust and blank fill, the 
FFW = hex 4306. 


Figure 1-14 shows how the display looks after all pre- 
viously described orders have been processed. 
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Cursor Field Attribute 


Location (not displayed) 


JACCOUNTS RECEIVABLE -- UPDATE MODEd 


JACCOUNT: a 
JNAME: a 
JADDRESS: ad 
ACITY/STATE: gd 
JZIP: a) 


d) 
d-~-DATE-- -~~CODE-- ~--LEDGER XREF-- =~+DEBIT<=*= -~-CREDIT 


ad 
qd 
qd) 
J 
ad 
ad 
d 
a) 
ad 
) 
a) 
a) 
ad 
a) 
a) 
a) 


@ & 2,0) G2) 8) & Bs Gs Gs GG Gs Os Gs Bs 
Qs 2) 2s By Gy Os fy Bs Os Os OO) Bs Gs OB 
@,@, 2, 2) Os 8s Gs Qs Oy Os Os Os OB Os2s 
@,2,2,8)0)85;8) 82) Qs Gs Os 2s Qs Os Os Bs 
@,@,@) 2) @,0)0)8) Gs Gs G8) Gs G18 Bs 
BesG@e,2G8)8) 222/08; Q8)2)8) 
Seas eaGaseabGGas8) 
G1 Gs Gs @) Gs Gs Gs Gs Gs Gs Os GI GG GBs 
@G2,20;02,0) 8) 8) 2, 2s Qs 2) Os Os Gs Bs 


Figure 1-14. Display Initially Written by the Programmer to the Screen 
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Updating the Display Continue to fill fields until all required fields are ) 
made available for operator update. Figure 1-15 


When the display is built as shown in the previous illustrates how the display will look. 

illustration, you may choose to fill some of the fields 

and make them available for user update. This is Remember, the RU chain is still being formed. Now 
accomplished in the following coding: insert a Read command so you can read any data the 


operator provides. 


ESC,WTD,CC,SBA,3, 16,’7-333’, 
SBA,4,16,’JOE SMITH’, 
SBA,5,16,'0000 B STREET’, 
SBA,6,16,,SOMETOWN, MN’, 


SBA,7,16,’99999’, 
SBA, 10,02,’11-10-77’,SBA,10,19,’20’, 
SBA, 10,27,’125670-100’,SBA, 10,46... 


All trailing attributes 

in fields defined by SF 
Cunsor are supplied by the controller. 
Location 


JACCOUNTS RECEIVABLE -- UPDAM 
7-333 a 


JARCCOUNT: 


aNAME: JOE SMITH 
JRDDRESS: 30000 8 STREET 
SCITY/STATE: ,dSOMETOHN, NN 
ZIP: a99999 


a-~DAT Saas Sf DEBIT-- ~-CREDIV-- 4 
ai1-10 3 34000 a 

ad11-11 ad 50000 a 

a11-20 a 100000 d 

a11-25 ad) a) a 

a) ad f a a d a) 
a da d d d d a 
a al a) a) ad dj ad 
a a a d ol a a) a) 
a) Jd a a a) a a) a 
a doa a d) a a a 
a d a ad J a) a) a 
a ad ad a) a d a) a 
ad ad @ a qd) ad ad a 
3 d a d a a a) d 
al Jd a a) al a a ad 
J d ad a a) ad a a 


Programming 
Filled Fields 


Figure 1-15. Display with Filled-in Update Fields J 
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C 


Building a Graphics Display 


The 5292 Color Display Station Model 2 can display 
alphanumeric (A/N) and graphic images, such as pie 
charts and line drawings, using flexible line styles 
and line widths. The displays can be in seven colors 
(plus black, which cannot be changed), selected from 
a palette of 512. 


The graphic images are displayed by selecting the 
color and a combination of addressable dots (PELs or 
picture elements) on the display screen. The PELs 
are addressed by X and Y coordinates as shown 
below. 


X Coordinate 
| 480 PELs | 


Y Coordinate 
288 PELs or 
Scan Lines 


4 


5292 Model 2 Graphic Orders allow the programmer 
to draw a line between X and Y coordinates (vector 
graphics), fill areas, and vary line style and width. 


The data stream for a graphics display is similar to 
the data stream for an A/N display. The main differ- 
ence is that the graphics display is defined in a unit 
called the graphic byte. The graphic bytes take the 
place of the data portion in an A/N data stream. All 
orders, locations, and colors are defined in a string of 
graphic bytes presented to the 5292 Model 2 as 
shown below. 


A/N Data Stream 


Graphics Data Stream 


,GRAPHIC BYTES 


The graphic bytes consist of Graphic orders, I/O 
feature orders, and data associated with the orders. 
The graphic bytes in a graphics data stream must 
begin with hex FF (Begin Graphics order), and end 
with hex 95 (End Graphics order) as shown below. 


Graphic Bytes 


Graphic Orders, 


F ; F | I/O Feature Orders, Data 


Graphic bytes are sent to the 5292 Model 2 in write 
blocks. A graphic write block has a maximum length 
of 256 bytes and a minimum length of 11 bytes. 
Graphic blocks may be sent to the 5292 Model 2 by 
single blocks, where each graphic write block begins 
and ends graphic mode as shown below. 


Single Write Block 


Graphic 


F | F | Bytes 


l~—— 956 Bytes Maximum —— 


If a group of blocks is sent, graphic data for certain 
orders may span blocks. For orders in which data 
can span blocks, the data can be split by using the 
More-Data-to-Come order (hex 91) as shown below. 
A detailed description of each Graphic order and 
whether data can span blocks for that order is con- 
tained in Section 2 of this manual. 


Multiple Write Spanned Blocks 


Graphic Graphic 


F | F | Bytes 911 | Bytes 


| 256 Bytes Maximum |< Last Block —| 
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A group of graphic write blocks can also be sent by 
using the End Graphics Block order (hex 90) to 
specify the end of a graphics write block without 
ending graphics mode as shown below. 


Multiple Write Nonspanned Blocks 


Graphic Graphic 


F 


—— 256 Bytes Maximum ——r|<— Last Block —»| 


The following data stream example shows the data 

stream that draws a red line on a green background 
that connects the x and y coordinates defined in the 
graphic bytes. 


[+ X Coordinate —+| 
| Green Background 
Y 


Coordinate 


4 


Red Line 


ESC,CU,ESC,WTD,CC, 


ESC,CU,ESW,WTD,CC, 


ESC 


Escape character (hex 04), required to begin 
each RU chain. 


CU 


Clear Unit command (hex 40), recommended to 
ensure the integrity of the data to be written to 
the display. This command clears the display 
and format table of all information. See the index 
entry clear unit command. 


ESC 


Escape character, required to link commands 
within an RU chain. 


WTD 


Write to Display command (hex 11), required to 
write any information to the display. This 
command has many associated parameters. As 
used here, these consist of the SBA and SF 
orders, control characters, screen attributes, 
display control words, and field control words. 
See the index entry write to display command for 
details. 


CC 


Two-byte control character associated with the 
Write to Display (WTD) command. In this case, 
the CC bytes are hex 00 and 08. In this example, 
only the second byte is functional; it unlocks the 
keyboard. See the index entry contro! characters, 
display for details. 
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J 


C 


,Graphic Bytes 


Graphic Bytes (11 Bytes Minimum) 


If there are fewer than 11 graphic bytes, pad with hex 
40. 


The following string of graphic bytes contains graphic 


orders and data that turn on the graphics display at 
the 5292 Model 2, define the color, display the 
graphic image, and define the end of graphic bytes. 
A coniplete description of each graphic order is con- 
tained in Section 2 of this manual. 


Byte 1 


Lee 


The first graphic byte value of hex FF identifies the 
following string of bytes as graphic bytes. 


Byte 2 


Loss| 


The second byte value of hex 93 (Graphic Display-On 
order) turns on the graphics display at the 5292 
Model 2. 


Bytes 3 and 4 


[a,3|4,2| 


The third byte value of hex A3 (Write Background 
order) writes the entire screen background with the 
color specified in byte 4. 


The fourth byte value of hex 42 (color index 2) identi- 
fies the color index to be written for the background. 
In this example, the default for color index 2 (green) 


is used. 


Bytes 5 and 6 


le,of4)i] 


The fifth byte value of hex BO (Set Color order) sets 


the color to be displayed for subsequent Draw orders. 


This color remains in effect until another Set Color 
order is processed. 


The sixth byte identifies the color index to be used. 
In this example, hex 41 (color index 1), the default 
value red is used. 


Bytes 7 through 11 


lajyo]a;ol[4jo]4jo|]aja| 


The seventh byte value of hex AO (Draw Polyline 
order) draws a line that connects the X and Y coordi- 
nates defined in the graphic data bytes that follow. 
This order will connect all points defined by the 
graphic data bytes until an End Of Data order is 
encountered. 


The eighth and ninth bytes identify the Xa coordinate. 


The tenth and eleventh bytes identify the Ya coordi- 
nate. 


Bytes 12 through 15 


4;1/6,;4/4,;0]7), 2 


The twelfth and thirteenth bytes identify the Xb coor- 
dinate. 


The fourteenth and fifteenth bytes identify the Yb 
coordinate. 


Byte 16 


Lose | 


The sixteenth byte value of hex 92 (End Of Data 
order) delimits the graphics data to be used by the 
Draw Polyline order. 


Byte 17 


Lois 


The seventeenth byte value of hex 95 (End Graphics 
order) delimits the graphics display data stream that 
started with the first graphic byte of hex FF. 
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How to Code X and Y Coordinates 


Yo 


The a coordinate is defined first in this data stream. 


The hexadecimal value for coordinates are determined 
by the 10 bit binary value as shown below. 


rf | 


0100 0000 0100 0000 0100 0000 0100 1010 


\sNlmd dan 


This 10 bit binary value This 10 bit binary value 
defines the coordinate defines the coordinate 
of Xa = 0. of Ya = 10. 


Note: Bits O and 1, value of 01, identify the graphic 
byte as data. 
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( Reading Fields from a vispiay CC 


The control characters are associated with the 
Read MDT command. In this example, the CC is 
hex 4000, which specifies that MDT bits of nonby- 
ESC pass fields are to be cleared after the Read 
command is serviced. 


Escape character (hex 04). It signals the begin- 


ning of another command. Note: The master MDT bit is also cleared. 
Read MDT The complete SNA RU is now sent to the LU. The 
operator updates the display and presses the 
The Read Modified Data Tag (MDT) command Enter/Rec Adv key. Figure 1-16 shows the changes 
(hex 52). When the operator alters a field on the the operator made on the display. 


display, the MDT bit for the field is set. Any field 
with an MDT bit on is sent to the host system 
when the operator presses an aid-generating key 
and when all field requirements have been met. 
See the index entries display, commands and 
aid-generating keys for details. 


Updated Fields 
JACCOUNTS RECEIVABLF/-- UPDATE MODEd 
JACCOUNT: 7-333 d Cursor Location 
NAME: JJOE SMITH a 
AADDRESS: J0000 B STREET d Updated Fields 
JCITY/STATE: dSOMETOWN, MN d 
aZIP: 399999 d 
d--DATE-- ; ; It-- 
d11-10-774 Os a 34000 
ad11-11-774 00a d 5000d 
3911-20-77 ahsot01-101a d 100000 
11-25-7740 W003145-1010 d f 
d12-04-774 d00a d000940-102a d 5000_7 3 d 
a d da d d d dd d a 
a a d a a d a dl d d 
a a da a a a r) d d 
a a d a d a d 3 r) a 
d d d a dl a d a al d 
a d da a a a a d a 
d d d a a a a a a a 
a 3 da a a a a mi) a 
a a da a a d d a d 
a a doa a ad a a d d 
( Figure 1-16. Display Updated by Operator Entry 
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The controller sends the host system the following Wrt Error Code J 
data stream when the operator presses the Enter/Rec 

Adv key. See the index entry aid-generating keys for The Write Error Code command (hex 21) 

details. allows the host system to force the keyboard 

into the prehelp error state. When the oper- 

ator presses the Error Reset key in response 

to the Write Error Code command, the key- 

board unlocks, so no Write to Display 

command is needed. See the index entry 

write error code command. 


14,59, Enter, 
SBA,5,16,/0000 B STREET’, 
SBA, 14,02,'12-04-77’ SBA, 14,19,’00’, 


SBA, 14,27,’000940-102’, 
SBA,14,46,’ 500’, 


IC,14,19 
14,59,Enter 
IC is the Insert Cursor order (hex 13). 14 and 
14,59 is the cursor address at the time the oper- 19 define the row and column where the host 
ator pressed the Enter/Rec Adv key. Enter system wants the Model 2 or Model 12 to set 
stands for the aid code (hex F1) that the Model 2 the cursor. This is the location of the error. 
or 12 sends the host system when the operator 
presses the Enter/Rec Adv key. @ 
Error Identification and Recovery The host system is responsible for the screen 
attribute. It should be high intensity blink for 
1. When the host system checks the incoming data, the first @ and nondisplay for the last @. 
it finds that the numbers sent in the last trans- Characters appearing in columns 2-5 of the 
action are invalid; it sends an error message to error line (9001 in this example) should be 
the operator to alert him of the problem. The some user text message that can be used to J 
code for the error message looks like this: index help messages. The host system 


should not duplicate error codes generated 


by the controller. See the index entry errors, 
ESC,Wrt Error Code,IC,14,19,@, codes. 


‘9001 -- INVALID TRANSACTION CODE, 


PRESS RESET AND CORRECT’,@, Figure 1-17 shows the display when the error 
ESC,Read MDT,CC, message is generated. 


JACCOUNTS RECEIVABLE -- UPDATE MODEd 


a ACCOUNT: 7-333 

JNANE: aAJOE SMITH 

JADDRESS: J0000 B STREET 

ACITY/STATE: aSOQMETOWN, MN 
399999 


--CODE-- - 


Field in Error 


2,2, 2@)2)85 


=DESIT == --CREDIT--o 
ad 


fo) 
= 
Oo 
So 
es 


Sees Beses 


Error Message 


BS&O202,8,8;8;8,8);4)8) 8) 2) | 
SVB saeaga Bey 
Qs, 82,0,6;8,8 0/0/80; 8058)8)85 I 
SVs gaeaeseaQaeee) 


a) 
ad 
a) 
a) 
a) 
ad 
qd) 
dl 
a) 
a) 
al 
qd) 


Lea) 
SVMs oeaeaG&sea 
VSSaea eee e) 


9001 -- INVALID TRANSACTION CODE, PRESS RESET AND CORRECTd 


Figure 1-17. Display Containing an Error Message 
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2. The operator presses the Error Reset key, cor- 
rects the error, and then presses the Enter/Rec 
Adv key. This data stream goes to the host 
system: 


14,27,Enter, 


SBA, 14,19,’20’, 


14,27,Enter 


This is the cursor location by row and column 
and the Enter aid code. 


SBA, 14, 19,’20’ 


This is the SBA order and associated param- 
eters that tell the host system that the 
number 20 is now to be placed into row 14 
and column 19 in place of whatever data was 
previously there. 


JACCOUNTS RECEIVABLE ~- UPDATE MODEd 


JACCOUNT: J7-333 Fl 

aNAME: JJOE SMITH ad Corrected 
JADDRESS: 30000 B STREET 

CITY/STATE: @SOMETOHN, MN d Field Entry 
dZIP: 399999 d 


--CODE-- - 


d 
a 
ad 
al 
d 
a 
a) 
ad 
qd) 
ad) 
a) 
al 
a 
d 
a) 


BesQ2sGbs G20, 0,0 0,885 

BSG 2,0,8j,8) 

BSG GGG; 6)/0) 8) & Bt 
{ 
1 

2,20,0;8;8 88/8, 8 2) 8,8; 0) 05 

See2e,e,882:8;8) 


Figure 1-18. Final Display 


Printer Data Stream Example 


This example shows the contents of a printer data 
stream. In normal applications, the data stream is a 
continuous stream of control characters and data; in 
this example, for purposes of explanation only, the 
data stream is broken into pieces. The comma isa 
byte separator. Within the character strings, each 


Note: Only the corrected fields are sent; previ- 
ously corrected fields are not resent. This is 
accomplished by the control character (MDT 
reset) that followed the first Read command. 


Figure 1-18 shows what the display looks like 
now that the error has been corrected. 


You can now write another RU chain to the 
display. 


Cursor 
Location 


--CREDIT--d 
a 
a) 


ro] 
= 
2 
fo] 
es 


Beeoeae828 882,88, 8)8) 
Q,0:2:0@,0)05)0)82)8) 05 


character represents 1 byte of EBCDIC code. No 
attempt has been made to represent the SNA headers 
or flags. Only the contents of the RU are given in this 
example. The example given here is a 256-byte block 
which is the maximum single transmission size. 
Figure 1-19 illustrates the result of the data stream. 
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34,C4,0B, 


34 


The print position (PP) control character. It 
establishes the print position where the next two 
parameters designate it. 


C4 
The absolute vertical functional parameter; of the 
PP control character. It establishes the vertical 


print position at the value set by the next param- 
eter. 


OB 
The hexadecimal value of the vertical print posi- 


tion. In this example, the printing will start on 
row 11. 


34,C0,10,,ABC ELECTRIC CO.’, 


34 
The PP control character. 
Co 


The absolute horizontal functional parameter of 
the PP control character. It defines the print posi- 
tion at the horizontal value given in the next 
parameter. 


10 
The hexadecimal value of the horizontal print 
position. In this example, the beginning hori- 


zontal print position is column 16. 


ABC ELECTRIC CO. 


The data that is written beginning in row 11 and 
column 16 of the page. 


15 


The hexadecimal code for the new line control 
character. It positions the printer at the first print 
position of the next line. 


The remainder of this code has the same meaning as 
the previous code did for the first line printed. These 
values will cause the printer to align the data given 
here with the data previously printed. 


15,15,34,C0,10,XYZ ELECTRIC INC., 
15,34,C0,10,WEST LAKE, 


15,34,C0,10, MINNETONKA, MINN., 
15,34,C0,10,55003, 


The only thing that differentiates this coding from the 
preceding coding is the use of the 15,15 to insert a 
blank line between the preceding block of data and 
this block of data. 


15,34,4C,03,34,C0,04,92354, 


In this block of coding, the programmer inserts three 
blank lines between the previous data and the data 
being written. This is accomplished by using the rel- 
ative vertical functional parameter (4C) of the PP (34) 
control character. The 03 defines the move as three 
lines down from the last print position. 


34,C0,10,PARCEL POST,34,C0,22,219614, 


34,C0,2E,40280,34,C0,3A,06/07/78, 


This block of code is writing the data horizontally at 
print positions 16 (hex 10), 34 (hex 22), 46 (hex 2E), 
and 58 (hex 3A). 


15,15,34,C0,04,245-2890,34,C0,10,Insulator, 


34,C0,27,2,34,C0,2E, .73,34,C0,49,1.46,15, etc. 


This coding skips two lines and then begins to print 
the data in the positions defined by the parameters of 
the PP control character. This data stream continues 
until the entire 256 bytes have been transmitted. The 
result is shown in Figure 1-19. See the index entry 
control characters, printer. 
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1234 SNELLING AVE. 
MINNEAPOLIS, MINN. 


ABC ELECTRIC Co. 
55401 
XYZ ELECTRIC INC. 
WEST LAKE, 
MINNETONKA, MINN. 
55003 | 
92354 PARCEL POST 219614 40280 06707778 | 
245-2890 Insulator 2 73 1.46 
917-1478 Relay 1 12.30 12.30 
258-1478 Battery 6 1.01 6. 06 
369-2587 Choke 10 2.47 24.47 
987-6543 Heat Sink 3 12.05 36.15 
654-3210 Generator 2 3.62 7.24 


Figure 1-19. Printer Output 
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Addresses 


The three addresses the controller uses when it is 
attached to the host system via a communications 
network are the LSID address, the controller station 
address, and the work station address. 


LSID Address 


The local session identification (LSID) is in byte 1 of 
the SNA transmission header (TH); see the index 
entry TH. This address allows the host system to 
identify to the controller which specific work station 
(LU) it wants to communicate with. Addressing in the 
5250 System in Section 1 of this manual describes the 
process the user must go through to determine the 
local address part of the LSID. The local station 
address is the last 6 bits of the LSID address. The 
first 2 bits are session type identifiers. 


The following chart shows the local station addresses 
for the 5294 Control Unit. The coordinate of the work 
station address and the port number is the local 
station address. 


Work Station Address 


The following chart shows the local station addresses 
for the 5251 Model 12 work station controller. 


00 


Work Station 
Address 
000 


LSID Local 
Address 


The 5251 Model 12 keyboard/display address is 
000000. 
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Controller Station Address 


The controller station address is in the A part of the 
SDLC frame (see the index entry frames); it allows 
the host system to address a specific controller. This 
address is defined by the user and set in the eight 
rocker switches on the 5251 access panel, or entered 
from a display station at setup time. 


Work Station Address 


The work station address is set on the displays and 
printers to allow the controller to communicate with a 
specific work station. The work station address is 
determined by the physical configuration of the 
user’s system. See the /BM 5250 Planning and Site 
Preparation Guide, GA21-9337, for details on setting 
this address. 


ASCII 


The 5294 Control Unit supports ASCII configured key- 
boards but does not support ASCII codes, systems, or 
work Station interfaces. 


Aid Codes 


The aid code identifies to the host system the function 
being requested from the keyboard. The aid code is 
returned via the Read Input or Read MDT command 
when the operator presses an aid-generating key. 
See the index entries display, commands and aid- 
generating keys. 


5250 Aid Codes 


Aid Code 
Generated (in Hex) 


Command 
Function 
Keys 


Clear 

Enter/Rec Adv 

Help (not in 
operator-error mode) 
Roll Down (or Page Up) 
Roll Up (or Page Down) 
Print 

Record Backspace 
Auto Enter (for Selector 
Light Pen) 
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Buffer Print Mode (4224, 5224, 
and 5225 Printers) 


Buffer print mode can be used by the programmer or 
service representative for problem determination 
among the printers, controller, and program, and as a 
software debug tool. 


When the printer is operating in buffer print mode, 
characters and formatting control codes are printed 
in hexadecimal code with the character representing 
the code printed below. To aid counting and identifi- 
cation, a hexadecimal count (buffer number) is 
printed above every sixteenth character and a ver- 
tical bar above every eighth character starting from 
the second character on the left. The second digit on 
the left column indicates the print buffer used. One 
line of data prints out as four lines in transparent 
mode. Formatting control codes are not executed but 
are treated as data. The default character is printed 
below the hexadecimal code for the formatting 
control codes and other unprintable characters. 


A sample buffer print mode printout is as follows: 
8th Character from Buffer Number 

Buffer 

‘ai 16th Character from Buffer Number 

ac 1 

CCLC4CC2CCCCDDDDOD 

1253045567891234D5 

AB|C ai aaa 


Line Feed Carrier Return 


Space Character 


New Line 


In normal mode, with the SCS control characters exe- 
cuted, the above will print as: 


AB 
C DE 
N  FGHIJKLM 


The 5256 Printer has a similar capability; see the 
topic Transparent Mode in this section. 


Procedure for the 4224 


The IBM 4224 Printer Operating Instructions, 
GC31-2546, provides a step-by-step procedure in 
using the buffer print mode for a 4224. 


Procedures for the 5224 


For the 5224 Printer, buffer print mode is in effect if 
these procedures are followed: the printer and 
system are in correct operating condition, the 5224 
Attention indicator is blinking, and the Ready indi- 
cator is off. 


To enter buffer print mode: 


1. Load forms at least 375 mm (14.8 inches) wide. 
. Press the Stop switch on the 5224 Printer. 
3. Press the Buffer Print switch on the 5224 Printer; 
the Attention indicator will blink. 
4. Press the Start switch on the 5224 Printer; 
printing in buffer print mode will begin. 


To leave buffer print mode, press the Stop switch. 
For more information about buffer print mode, see 
the IBM 5224 Printer Operator's Guide, GA34-0092. 


Procedures for the 5225 


For the 5225 Printer, use the following procedures to 
enter and leave buffer print mode. 


To enter buffer print mode: 


1. Load forms at least 375 mm (14.8 inches) wide. 
. Press the Stop switch on the 5225. 
3. Set the Mode switch on the 5225 to the buffer 
print position. 
4. Press the Start switch on the printer; the Ready 
light will come on and printing in transparent 
mode will begin. 


To leave buffe. print mode: 


1. Set the Mode switch back to the Online position. 
2. Press the Stop switch. 


For more information about buffer print mode, see 
the /BM 5225 Printer Operator’s Guide, GA34-0054. 


Note: The 5225 Printer provides a system trans- 
parent mode (buffer print transparent mode) in the 
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SCS control character. See the index entry printer, 
code for. 


CD (Change of Direction) Bit 


The change of direction bit is bit 2 of byte 2 of the RH. 
It reverses the normal flow direction and is examined 
only on RUs with the End Chain indicator on. It is 
used in the normal flow LU-LU session FM RUs and 
DFC RUs. See Protocols and Synchronization for 
5250 Implementation of SNA in Section 1 for more 
information. 


Chaining 


The SNA chain carries commands and information 
between the host system and controller. The length 
of the chain is not restricted; it can contain multiple 
RUs. See the index entry RU. The first RU is marked 
first in chain (FIC); the last is marked last in chain 
(LIC); and all in the middle are marked middle in 
chain (MIC). The RH that immediately precedes the 
RU in the SDLC frame contains the information about 
the position of that RU in the SNA chain (see the 
index entry RH). See also Protocols and Synchroni- 
zation for 5250 I[mplementation of SNA in Section 1 
for a description of how this information is used. 


Clock (Synchronous) 


The 5251 Model 12 has a clock feature that is offered 
for external modems that do not provide their own 
clocking. It is also required when the 1200 bits per 
second (bps) Integrated Modem feature is installed. 
The internal clock provides clock speeds of 1200 bps 


with 690 bps also available for World Trade countries. 


Color Alignment (5292 Only) 


Color alignment is adjustable with an operator- 
pertormed procedure in select option mode. (See the 
index entry se/ect option mode keys for information 
on this procedure.) 


Commands 


The four types of commands that are described in 
detail in the following text are: display data stream 
commands, SDLC commands, SNA commands, and 
transmission commands. 


Display Data Stream Commands 
The display commands are in the LU-to-LU flow. 


Note: The printer does not use Data Stream com- 
mands to interface to the host system; it uses an SNA 
SCS character string or IPDS data stream for the 4224 
printer. (The printer does use the Transmission 
command set that the 5251 Models 2 or 12, or 5294 
supplies.) This is referenced by the index entry 
control characters, printer. 


Both the display commands and the display 
responses are found in the SNA RUs. These are 
routed between the host system and Models 2 and 12, 
or 5294, in the FM data flow. See Figure 1-13 fora 
list of the SNA sessions and their contents. The 
format of the display data stream is: 


Escape Command Associated Data Repeat 

Character or Parameters Sequence 
or SNA 
Chain End 


The Display commands form two basic categories: 
the input commands and the output commands. 


The following are the commands that the user’s 
output application program uses to control the 


display: 
Output Commands 


Clear Format Table 
Clear Unit 


Input Commands 


Read Immediate 
Read Input Fields 
Read MDT Fields Clear Unit Alternate 
Read Screen Restore Screen 
Save Roll 

Write Error Code 


Write to Display (See also 
the index entry copy to 
printer feature.) 
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For each command, the following text includes func- 
tion, restrictions, format, and results. 


Input Commands 


This category consists of immediate and aid- 
associated Read commands. The immediate com- 
mands are those that are executed when the 
controller receives the command, and the aid- 
associated commands are those that are queued until 
the operator presses an aid-generating key such as 
Enter/Rec Adv. The immediate commands are titled 
as such; those not labeled as immediate are aid- 
associated. For details about aid codes, see index 
entries aid-generating keys and aid codes. 


The host system sends the Read commands to the 
controller in the LU-LU FM session; when the con- 
troller receives the commands, it determines if they 
are immediate or aid-associated. If they are imme- 
diate, they are executed without delay. If they are 
aid-associated, the controller queues them until it 
receives an aid code caused by the operator pressing 
an aid-generating key. These aid-associated com- 
mands are held one at a time in a queue until the 
addressed LU can perform the requested function. 
When multiple Read commands are sent to a display 
to be enqueued, only the last one is preserved; the 
others are overlaid. 


Note: When an aid code is serviced, the command is 
cleared. 


Read Immediate (Immediate) 


Function: This command sends back the contents of 
all the input fields on the display. 


Restrictions: This command must be the last 
command in the chain (see Protocols and Synchroni- 
zation for 5250 Implementation of SNA in Section 1), 
and the controller must have CD (see the index entry 
CD). This command is rejected if the station is in an 
error, system request, or SS message state. 


Note: If the display supports a separate message 
line, and the message line is selected, the command 
is rejected only for system request and SS message 
states. The command is processed with the display 
in error state. 


Format: 
ESC Read Command LIC or OIC 
Hex 04 Hex 72 


Results: The information associated with this 
command returns to the user in the LU-LU nonexpe- 
dited flow. What the user receives when he issues 
this command depends on the condition of the master 
MDT bit. See the index entry MDT bit. 


e Ifthe master MDT bit is not set, the user 
receives: 


Cursor Address’ Aid Code 
e If the master MDT bit is set, the user receives: 
Cursor Address Aid Code Field Data 


The field data consists of the contents of all input 
fields as they appear on the display unless rese- 
quencing has been specified. See the index entry 
field control words. Remember, any attributes con- 
tained in a field are treated as data and returned as 
such. Field boundary attributes are not considered 
part of the field. All nulls are converted to blanks. If 
the specified field is a signed numeric field, the last 
character is not sent; if that same field is negative, 
the zone position of the next-to-the-last character is 
changed to hex D. 


In each case, the returned cursor address indicates 
the current location of the cursor and the aid code is 
hex 00. 


Note: Queued Read commands and pending aid 
codes are not cleared. The format table, display indi- 
cators, insert and command modes keying history, 
and display contents are not affected. 
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Read Input Flelds 


Function: This command allows the host system to 
have the controller send the contents of all input 
fields defined in the format table. 


Restrictions: The operator must press an aid- 
generating key to execute this command. See the 
index entry aid-generating keys. Also, CD in the RH 
must be on before the aid byte can be serviced. (See 
index entry CD.) This command is cleared if: 


1. The host system issues a session control request 
(such as Unbind). 


2. The host system issues a Clear Unit command 
and the controller executes it. 


3. The host system sends another Read command 
to the same LU and overlays this command. 


4. The Read command is executed. 


Format: 
ESC Read CC ESC or 
Hex 04 Command (see note) SNA 
Hex 42 Chain End 


Note: This is a 2-byte control character executed 
after field data read. See the index entry control 
characters, display for details. 


Results: The information associated with this 
command returns to the user in the LU-LU nonexpe- 
dited flow. Note that the host system cannot receive 
this information until the operator presses an aid- 
generating key. See the index entry aid-generating 
keys. What the user receives when he issues this 
command depends on the condition of the master 
MDT bit. See the index entry MDT bit. 


- If the master MDT bit is not set, the user 
receives: 
Cursor Address Aid Code 

— Cursor Address: The position of the cursor 
when the aid-generating key was pressed. 


— Aid Code: The code for the aid-generating 
key the operator used. 


e |f the master MDT bit is on, the user receives: 


Cursor Address Aid Code _ Field Data 

— Cursor Address: The position of the cursor 
when the aid-generating key is pressed. 

— Aid Code: The code for the aid-generating 
key the operator used. 

— Field Data: Returned only when one of the 


following aid-generating keys is used: 


Rollf Up 

Roll) Down 

Enter/Rec Adv 

Auto Enter 

An unmasked command function key 


When it is returned, the field data consists of 
the contents of all input fields as they appear 
on the display unless resequencing has been 
specified. See the index entry field control 
words. 


e If any of the following keys are pressed, the user 
receives: 


Cursor address 

Clear 

Help 

Print 

Record Backspace in home position 


Remember, any attributes contained in a field are 
treated as data and returned as such. Field attributes 
are not considered part of the field. All nulls are con- 
verted to blanks. All pending aid request bytes are 
cleared. If the specified field is a signed numeric 
field, the last character is not sent; if that same field 
is negative, the zone position of the next-to-the-last 
character is changed to hex D. Though data is not 
sent, the CC bytes are processed. 
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Read MDT Fields 


Function: This command allows the host system to 
ask the controller to send data from only those fields 
that have been modified. A field is recognized as 


having been modified if the MDT bit for the field is on. 


See the index entry MDT bit. 


Restrictions: The operator must press an aid- 
generating key to execute this command. See the 
index entry aid-generating keys. In addition, the CD 
in the RH for the requested LU must be on before any 
information can be sent back to the host system in 
response to the command. See the index entry CD. 
The command is cleared if: 


1. A-session control request (such as Unbind) is 
issued by the host system. 


2. A Clear Unit command is issued. 


3. The host system sends another Read command 
to the same LU and overlays this command. 


4. The Read command is serviced. 


Format: 
ESC Read CC ESC or 
Hex 04 Command __ (see note) SNA 
Hex 52 Chain End 


Note: Two bytes of control characters executed after 
field data read must be included in this command. 
These are referenced by the index entry contro/ char- 
acters, display. 


Format of Returned Data 


Aid Code SBA Row, Field 
Address Hex 11 Column Data 
(2 bytes: Address 

row, (This 

column address 

points to 

the first 

data 

character 

in the 

field, not 

the 

starting 
attribute.) 


Cursor 


Results: The contents of each field that has an MDT 
bit on are returned to the host system in the order 
that the fields appear in the format table, if one of the 
following aid-generating keys is used: 


Rollf Up 

Roll) Down 

Enter/Rec Adv 

Unmasked command function keys 


If no MDT bits are on or if the operator does not use 
one of the acceptable aid-generating keys (Clear, 
Help, Print, Record Backspace), only the cursor and 
aid code are returned to the host system. 


The host system can use field control words to rear- 
range the sequence in which the fields are returned. 
See the index entry field contro! words for more 
details. 


If data is returned, the following formatting is done. 
If the field is not a transparent data field: 


e Trailing nulls are stripped. If the field consists of 
all nulls, only the SBA, row, and column are 
returned. 


e Leading and embedded nulls are converted to 
blanks. 


If the field is signed numeric, the last character is not 
sent; if that same field is negative, the zone position 
of the next-to-the-last character is changed to hex D. 


Remember that hex 10 and hex 11 are used as 
control data; therefore, avoid writing hex 10 and hex 
11 to the display as data unless they are written in 
transparent data fields. See the index entry field 
control word for more information on transparent 
data fields. 


Read Screen (Immediate) 
Function: This command causes the contents of the 
display to go to the host system in the sequence that 


it appears on the display; for example, row 1 goes 
first. 
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Restrictions: This command must be the last 
command in the SNA chain, and CD must be on. See 
Protocols and Synchronization for 5250 Implementa- 
tion of SNA in Section 1 and index entry CD for more 
information. The command is rejected when the 
addressed display is in the prehelp error, posthelp 
error, system request, or SS message state. 


Note: If the display supports a separate message line, 
and the message line is selected, the command is 
rejected only for system request and SS message 
states. The command is processed with the display 
in error state. 


Format: 
ESC Read Command SNA Chain End 
Hex 04 Hex 62 


Results: The content of the entire display, including 
the attributes, is sent to the host system just as it 
appears in the regeneration buffer (no formatting or 
conversion is done). Cursor address and AID are not 
returned. This command does not clear either 
pending read commands or aid requests. The key- 
board is temporarily locked. The following are unal- 
tered: display indicators, cursor location, modes, 
keying history, display contents, and format table. 


Save (Immediate) 


Function: This command allows the host system to 
save the present display so it can be restored later. 


Note: This is accomplished by sending back the data 
received after a Save operation. See index entry 
restore screen command. 


Restrictions: This command must be the last 
command in the SNA chain and CD must be on. See 
Protocols and Synchronization for 5250 Implementa- 
tion of SNA in Section 1 and index entry CD. The 
command is rejected if the addressed LU is in either 
the system request or the SS message state. 


Format: 
ESC Save Command SNA Chain End 
Hex 04 Hex 02 


Results: All data required for restoring the display is 
sent to the host system; it must not be modified by 
the host system if the result of the Restore command 
is to have integrity. See index entry restore screen 
command. 


On the 5251 Models 2 and 12, approximately 2K bytes 
are returned to the host system for the 960-character 
display and approximately 3K bytes for the 
1920-character display. On the 5294, the amount of 
data returned to the host is variable in length, 
depending on the number and size of the input fields 
and the actual screen image to be saved. In order to 
improve response time, the 5294 compresses the 
screen image, reducing the amount of data that 
needs to be transmitted to the host and back. This 
compression is entirely internal to the 
SAVE/RESTORE code in the 5294 and has nothing to 
do with SNA support for data compression, which is 
not supported. 
Estimated maximum: 4000 bytes of data 

for a 24 x 80 display station 
presentation space 


5200 bytes of data 

for a 27 x 132 display station 

presentation space 
Estimated typical: 1200 bytes of data 
for 40 input fields and 50% 
effective data compression 
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Read commands and pending aid requests are not 
cleared when this command is executed. The key- 
board is temporarily locked. The display indicators, 
cursor location, modes (command and insert), keying 
history, display content, and format table are not 
affected by this command. 


Output Commands 


The output commands are Clear, Clear Format Table, 
Clear Unit, Restore Screen, Roll, Write Error Code, 
and Write to Display. Some of the commands have 
associated data and control information (write char- 
acters and orders). The control information is not 
included in this topic; see the index entries control 
Characters, display and orders for details about these 
topics. The Write commands are executed imme- 
diately. 


Clear Format Table 


Function: This command clears the format table but 
does not affect the present display. 


Restrictions: The command is rejected if the LU is in 
an error, system request, or SS message state. 


Note: If the display supports a separate message 
line, and the message line is selected, the command 
is rejected only for system request and SS message 
states. The command is processed with the display 
in error state. 


Format: 
ESC Clear Format SNA Chain End 
Hex 04 Table Command or ESC 
Hex 50 


Results: The following list describes what happens 
when this command is executed: 


e The keyboard is locked. 


— The keyboard clicker is turned off. 

— The Input Inhibited indicator on the display is 
turned on. 

— The insert mode is cleared (as is the indi- 
cator). 

— The command mode is cleared. 


e The format table is cleared. The format table 
header formats like this: 


Hex 00 
0 (Resequencing is 


Format ID 
First field transmitted 


disabled) 
Bottom line of 
display 


e The system insert cursor address is set to row 1, 
column 1; this clears any previous IC order. 


e Any pending aid request is cleared. 
e All keying history is cleared. 
e The master MDT bit is cleared. 


e A blinking cursor caused by waiting for a 
required field exit key is reset. 


Note: Operator-selected reverse image and the 
Message Waiting indicator are not affected by this 
command. 


Clear Unit 


Function: This command clears the display and 
format table. 


Restrictions: The command is rejected if the display 
is in the SS Message state. 


Format: 
ESC Clear Command ESC or 
Hex 04 Hex 40 SNA Chain 
End 


Results: The following describes what happens 
when this command is executed: 


e The keyboard locks. 


— The clicker is turned off. 

— The Input Inhibited indicator is turned on. 
— The error state is cleared. 

— The system request state is cleared. 

— The insert mode is cleared. 

— The command mode is cleared. 
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e The format table is cleared. Because this is not 
format level 0, a default header is assumed. See 
the Clear Format Table command. 


e The display is cleared of all characters by nulls 
being written to the regeneration buffer. 


e A nonblinking, nonreverse image with a normal 
intensity screen attribute is written to the regen- 
eration buffer. 


e The cursor position is row 1, column 2. 


e The system IC (insert cursor) address is set to 
row 1, column 1 (clearing any previous insert 
cursor orders sent by the host system). 


e All unserviced aid requests are cleared. 

e The history of previous keystrokes is cleared. 
e The master MDT bit is cleared. 

e If the cursor is blinking, it is reset. 


e Pending Read Input or Read MDT commands are 
cleared. 


e If the display supports an alternate presentation 
space size, the display is reset to 24 x 80 mode. 


e The default error line is set either to line 24, or, if 
supported, to the separate message line. 


Note: Operator-selected reverse image and the 
Message Waiting indicator are not affected by this 
command. 


Clear Unit Alternate 


Function: The Clear Unit Alternate command is sup- 
ported only by the 5294. It performs all the normal 
Clear Unit functions and also sets the display mode 
to 132 x 27. Clear Unit is used to set it back to 80 x 
24. 


Restrictions: This command is rejected when the 
display is in SS message state. It is also rejected 
with a 10030101 negative response if the addressed 
device does not support the alternate display mode 
and with a 10030105 if the parameter byte has an 
invalid value. 


Format 
Clear Unit 

ESC Alternate Command Parameter 

Hex 04 Hex 20 see below 
Parameter 
Byte Meaning 
X’00’ Maintain currently defined partition 
X’40’ Reset currently defined partition 


Note: The distinction between a parameter value of 
X’00’ and X’40’ is not significant for the 5294. Both 
values result in the same action. Other values result 
in a negative response. 


Results: When the Clear Unit Alternate command is 
executed, the following action takes place: 


e The keyboard is locked. 
e The keyboard clicker is turned off. 


e The Input Inhibited indicator, on the display, is 
turned on. 


e The error state is cleared. 
e The system request state is cleared. 


e The insert mode is cleared along with the indica- 
tors on the display. 


e The command mode is cleared. 
e The read resequencing is reset. 


e All PA/PF keys are set up to return data. 


e The default error line becomes the message line. 


e The display is cleared of all data by writing nulls 
to the regeneration buffer. 


e The display is set to the 27-row by 132-column 
presentation screen size. 


e An attribute of non-blink, non-reverse image, 
normal intensity is written into the regeneration 


buffer at Row 1, Column 1. 


e The cursor is placed at Row 1, Column 1. 
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e The system insert cursor address is set to Row 1, 
Column 1. 


e Any Aid request, not already serviced, is cleared. 
e Keystroke processing states are reset. 

e The master MDT bit is cleared. 

e Blinking cursor is reset. 


e The effect of the format table on keyboard shift is 
cleared. 


e Pending Read Input or Read MDT and associated 
control characters are cleared. 


Restore Screen (Immediate) 


Function: This command restores the contents of the 
display by returning data saved in the Save 
command. 


Restrictions: This command is rejected when the 
station is in a system request or SS message state. 
To be accepted, the command must be issued to a 
device that is the same machine type, model, and 
release as the one that received the Save command. 


Format: This is generated via a Save command; 
therefore, all the operator has to do to execute this 
command is to return the data received as the result 
of the Save command. 


Results: The following describes what happens 
when this command is executed: 


e These things are restored: 


— Contents of the display. 

— Contents of the format table. 

— State of the keyboard including the insert 
mode with the indicators and the command 
mode. 

— Location of the cursor and the way it was dis- 
played. 

— System insert cursor address. 

— State of the master MDT bit. 

— Error code and any explanatory information 
provided by the host system in the Write 
Error Code command, if display station was 
in an error state. The error code and any 


information are returned via the operator’s 
use of the Help key. 

— Requirements to send LU-LU Lustat when 
error line is available. 

— Any Read command that was pending at the 
time. 

— Any aid requests that were outstanding at the 
time of the Save command. 


e Dead key diacritic and hex modes are cleared. 
e This data is not restored: 


— Shift and shift indicators 

— State of the Message Waiting indicator 

— Requirement to send SS-LU Lustat when 
error line is available. 


e The following conditions cause a parameter 
error: 


— Invalid data is detected. 
— The required amount of data is not received. 


Note: A Clear Unit command is executed if an error 
is detected. 


Roll 


Function: This command allows the lines to be 
rolled up or down on the display as specified by the 
size parameter of the command. 


Restrictions: The command is rejected if the display 
is in the prehelp error, posthelp error, system 
request, or SS message state. 


Note: If the display supports a separate message 
line, and the message line is selected, the command 
is rejected only for system request and SS message 
states. The command is processed with the display 
in error state. 


Format: 
ESC Roll Parameters ESCor 
Hex 04 Command 3 bytes SNA Chain 
Hex 23 (see note) End 
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Note: The following describes the contents of the 
three parameter bytes: 


Description 


0 = Roll up 1 = Roll down 
Reserved 

Number of lines that the 
designated area is to be rolled 


Line number defining the top 
line of the area that will 
participate in the roll 


Line number defining the 
bottom line of the area that will 
participate in the roll 


Results: The following describes what happens 
when this command is executed. 


e The display is rolled as designated. 
e Lines vacated by the roll are not cleared to nulls. 
e The format table is not affected. 


Note: If the display does not conform to the 
format table, the roll should not be done. 


e The lines rolled out of the area are lost (cannot 
be rolled back onto the screen). 
e The state of the keyboard is not affected. 
e Pending aid bytes are not affected. 
e The following conditions cause parameter errors: 
— Atop line of zero 
— Atop line greater than or equal to the display 
length 
— A bottom line of zero 
— A bottom line greater than the display length 
— Atop line greater than or equal to the bottom 
line 
— Arroll area greater than the bottom line 
minus the top line. 


Write Error Code 
Function: This command allows the host system to 


force the keyboard into the prehelp error state. See 
index entry error states. 


Restrictions: The command is rejected if the display 
is in the preheip error, system request, or SS 
message state. 


Note: If the display supports a separate message 
line, and the message line is selected, the command 
is rejected only for system request and SS message 
states. The command is processed with the display 
in error state. 


Data must not exceed 80 characters (1 display line). 
See Step 9 in the Results heading of this topic. 


Format: 
ESC Write IC Order Screen Screen ESC 
Hex Error R/C Attributes Attributes or 
04 Command Address Data (see SNA 
Hex 21 Hex 13 note) Chain 
End 


These are optional, although 

at least one of them must be 
included to make the command 
valid. 


An Insert Cursor (IC) order can appear anywhere 
within the data. If an IC order is included at a certain 
display station location, it immediately moves the 
cursor to that display location without altering the 
system insert cursor address. All keying history is 
lost; therefore, field checks such as self check and 
mandatory fill are inhibited. 


If an IC order is not included, the cursor remains 
where it was at the time of error. See the index entry 
IC order. 


Note: The user should include field attributes of his 
choice, but it is recommended that the leading and 

trailing attributes be high-intensity blink and nondis- 
play attributes respectively. 


Results: When the operator presses the Help key 
(prehelp error state only) in response to the error 
condition, characters from columns 2, 3, 4, and 5 of 
the error line are returned to the host system ina 
packed form and sent as a Signal command. These 
characters form an index code that elicits a user- 
generated description of the error for the operator. 
See the index entries signal command, command and 
response code for details. 
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e The prehelp error state is selected for the key- 
board. 


e =The Input Inhibited indicator is on. 
e The keyboard clicker is off. 


e The insert mode and insert indicators are 
cleared. 


e The command, dead key diacritic, and hex modes 
are cleared. 


e The cursor is blinking. 


e The line in the format table header defined as an 
error line is saved. See index entry SOH order. 


e The cursor moves to the location specified by the 
IC order. If no IC order is given, the cursor does 
not move. 


e All characters (except IC order) found between 
the command byte and the end of the chain or 
next ESC are written on the error line. If the data 
exceeds 80 characters, an error occurs. 


e All outstanding aid bytes are cleared. 


e When the operator presses Help, the controller 
places a nonblink high intensity attribute in 
column 1 of the error line, replacing anything that 
was previously there. 


e The locked state of the keyboard is cleared if the 
keyboard was locked and the station was not ina 
posthelp error state; this allows the operator to 
release the keyboard by pressing the Error Reset 
key. 


The following conditions cause parameter errors: 


e Neither an IC order nor data follows the 
command. 

¢ Invalid IC order. 

e More data than 80 bytes is specified. 


Write to Display 


Function: The Write to Display (WTD) command 
writes characters and attributes into the display 
regeneration buffer and creates, adds to, and modi- 
fies the format table that is associated with the 
display. 


Restrictions: This command is rejected if the display 
is in a prehelp error, posthelp error, system request, 
or SS message state. 


If the display supports a separate message line, and 
the message line is selected, then only system 
request or SS message state result in a contention 
state error. If the error line is in use, however, and 
the Write to Display attempts to redefine the error 
line (using SOH byte 4), a negative response is gen- 
erated. 


Format: 
ESC Write CC2 Orders ESC or 
Hex Command Bytes andData SNA Chain 
04 Hex 11 (See (See End 
Note 1.) Note 2.) 
Notes: 


1. CC are the write control characters. See index 
entry contro! characters, display. 


2. The orders are described in detail as referenced 
by index entry orders. Any character that Is not 
an order and not associated with an order is con- 
sidered data, and is written on the screen at the 
current display address. The address is then 
incremented by 1 for each character written. 
These characters should be hex 00, hex 1C, or 
above hex 1F, so there is no conflict with the 
codes reserved for orders. 


Results: The display contains exactly what was 
specified in the control characters and orders: 


e The state of the keyboard is not affected by the 
Write to Display command unless one of the fol- 
lowing is specified (in which case the locked 
state results): 


— An SF order is used to define the input field. 
— An SOH order is present. 
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— CC byte 1 specifies either clear MDT bits or 
clear input fields. 


e The physical location of the cursor is not affected 
if the keyboard is in the unlocked state when the 
Write to Display command is detected, and it 
remains unlocked after processing the control 
characters and all orders. For all other condi- 
tions, the cursor is moved to one of the following 
places: 


— The IC order specified by the host system 
— The first nonbypass field 
— Row 1, column 1. 


e If the keyboard is in the unlocked state when the 
Write to Display command is detected, it is pos- 
sible for the controller to go to the error state 
between RUs. This results in the command being 
rejected after being partially processed. This can 
be avoided by issuing single RU chains when the 
keyboard is in the unlocked state. 


Note: If initially writing to the display, it is a good 
practice to issue a Clear Unit command before 
issuing the Write to Display command to ensure 
that the format table is not at format level 0. Do 
not use the Clear Unit command for updating a 
display. 


The following conditions cause parameter errors: 
— Invalid orders; see the index entry orders. 


— No data, orders, or CC follow the command 
byte. 
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SDLC Commands and Responses 


As described in the heading Frame-SDLC in this 
section, unnumbered and supervisory frames contain 
commands (and responses) that serve the data link 
and link level needs of the host system-5250 system 
communication transfer. Normally, these commands 
and responses are transparent to the user. They are 
included in this manual because not all commands 
and responses available with SDLC are supported by 
the 5250 system. The following information gives the 
command and associated response name and tells 
whether or not it is supported by the 5250 system. 
The commands and responses are grouped by format 
type (nonsequenced commands and responses, 
supervisory format commands and responses, and | 
frames). Because a user can affect the contents of 
the XID command, specific bit information about the 
XID command contents is included in this text. 


Section 2. Encyclopedia 


2-15 


Unnumbered (Nonsequenced) Commands and Responses 


The following commands and responses are supported for all operations: 


Supported Hexadecimal 

Commands Responses Y= Yes; N= No/|Code Description 

DISC (Disconnect) Y 53 with P bit Places the work station in the 
normal disconnect mode and 
goes onhook in a switched 
environment. (See Note 1.) 

UA (NSA) Y 73 with F bit Indicates that the disconnect is 

(Unnumbered 

Acknowledgment/ 

Nonsequenced 

Acknowledgment) 


complete; the work station is 

now in a normal disconnect 
mode (onhook for switched 

US (NSA) 73 with F bit 


lines). 
— 
Notes: 


1. If this command is received when the controller is in normal disconnect mode, the response will be DM. 


SNRM (Set Normal 
Response Mode) 


Places the controller in the 
normal response mode. 


Verifies that the controller is in 
normal response mode. 


The user can send a maximum 
of 256 bytes of data with this. 


This returns the data sent with 
the Test command. (See Note 
2.) 


2. If the data associated with the Test command exceeds 256 bytes, the command is returned with no data. 
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Supported Hexadecimal 
Responses Y = Yes; N=No/|Code Description 


XID (Exchange Station Y BF with P bit |Requests information about the 

Identifier) addressed work station. The 
controller interrogates byte 16 
(LOC) of the XID command. If 
byte 16 is 7 or less, the 
controller uses the value; 
otherwise the default is 7. 


BF with F bit |Returns 20 bytes of information 


about the work station. See 
FRMR (CMDR) (Frame Y 97 with F bit 
Reject/ 
Command Reject) 


XID in this topic for details. 
Disconnect Mode (DM) 1F with F bit 


Note: FRMR (CMDR) or DM will never be returned as a response to XID or Test. 


This is sent in the normal 
response mode. It is sent when 
there is an invalid command, 
there is data in a command 
where data is not acceptable, 
or the Nr count is out of range 
in either direction (see note). 


Indicates that the controller is 
in normal disconnect mode 
(see note). 


The following commands and responses are Sup- 
ported by the 5251 Model 2 or Model 12 for loop oper- 
ation only. If they are received when your system is 
in a loop operation, they will be treated as nonsup- 
ported commands. 


The 5294 does not support loop operations and will 
send FRMR and accept CFGR in normal response 
mode. 


Supported Hexadecimal 
Commands Responses Y = Yes; N=No/|Code Description 


NSP (UP) Y, if loop 23 without P bit | Used to solicit information or 
(Nonsequenced Poll/ Baer alien: 33 with P bit responses from loop 
Unnumbered Poll) terminals. 


CFGR (Configure) Y, if loop C7 without P bit |}Used for diagnostic 
operation. D7 with P bit purposes. 


CFGR Y, if loop C7 without F bit |If a data byte is received 
operation. D7 with F bit with the response, the 
controller has accepted the 
CFGR command. 
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The contents of the XID response are as follows: 


Code (X = Hex and 
Bits B = Binary) Meaning 


B’0001’ Variable format. 
B’0001’ 


B’000000100000’ (5251) |Block number. 
B’000001000101’ (5294) |Specific ID. 
B’0000’ 
ata 

(See Note 1.) 


a C 
poo contigurationtiags, 


Configuration Code for Secondary Station 


PU characteristics. (See Note 2.) 
B’1’ (5251) PU can receive FM RUs from SS. 
B’0’ (5294) Reserved. 
B’0’ Reserved. 
B’11’ No segments allowed. 
B’0000’ Reserved. 


SDLC command profiles. 
Reserved. 
SNA set. (See Note 4.) 


1. Bits 24 through 31 contain the controller station address. See the /BM 5250 Planning and Site 
Preparation Guide, GA21-9337, for details on setting this address. 
2. This field describes the restrictions, if any, on the PU the user is using. 
3. This is a binary count of the maximum number of bytes in the information field. Bit 0 is a flag. 
4. Bits 4 through 7 of byte 12 contain the SDLC function profile. Value X’0’ defines the SNA link 
set. The SNA link set is: 
Commands Responses 
l-frames I-frames 
RR RR 
RNR RNR 
TEST TEST 
XID XID 
SNRM NSA (UA) 
DISC DM FRMR (CMDR) 
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Code (X = Hex and 
Bits B = Binary) Meaning 
13 


SDLC function flags. 

B’0’ Reserved. 

B’0’ Reserved. 

B’0’ SIM and RQI (RIM) not supported. 
B’00000’ Reserved. 

X’00’ Reserved. 

X’00’ Reserved. 

X’03’ or X’07’ Maximum out count (see note). 
X’00’ Reserved. 


Note: This is the maximum number of consecutive frames the controller is able to accept. It will 
always be either 3 or 7 for the 5251, and 7 for the 5294. 
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Supervisory Format Commands and Responses 


Supported Hexadecimal 
Commands Responses Y = Yes; N= No|Code Description 


RR (Receiver Ready) Variable Host system is ready but has 
no data to send the controller; 
it is asking if the controller has 
data to send. This also 
acknowledges previously sent | 
data (see note). 

(Receive Ready) Variable The controller is ready but it 
has no data to send the host 
system at this time. This also 
acknowledges previously sent 
data. 

RNR (Receiver Not Variable There are no available buffers; 
therefore, no | frames from the 
host system can be accepted. 
This also acknowledges 
previously sent data. 


Ready) 
| Frame Y Variable This contains the SNA RUs 
from the controller. 

Variable There are no available buffers; 
therefore, the host system 
cannot accept any | frames 
from the controller (see note). 

RNR (Receiver Not Variable Same meaning as RNR 

Ready) command. This also 
acknowledges previously 
sent data. 

Variable The controller is ready, but it 
has no data to send at this 
time. This also acknowledges 
previously sent data. 


Note: FRMR (CMDR) or DM may be sent as a response. 


RNR (Receiver Not 
Ready) 


RR (Receiver Ready) 
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Nonsupported Commands and Responses 


The following commands and responses are not sup- 
ported by the controller. If these commands are 
received while the controller is in normal disconnect 
mode, the response will be DM. If these nonsup- 
ported commands are received while the controller is 
in normal response mode, the response will be 
FRMR (CMDR). 


Command contains nonsequenced 
(unnumbered) information. 

NSI (Ul) Response contains nonsequenced 
(unnumbered) information. 

SIM (Set Initialization Mode) Command is dependent on system use; 
consult your host system documentation. 


RQI (RIM) (Request/ Initialization needed; expect SIM. 
Initialization/Request Initialization 
Mode) 


RQD (RD) (Request Disconnect) Request to be placed in disconnect mode. 


REJ (Reject) Transmit, starting with frame Nr. 
REJ (Reject) Retransmit, starting with frame Nr. 


NSI (UI) 
(Nonsequenced Information/ 
Unnumbered Information) 
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| Frame SDLC Responses 


The | frames contain the SNA RUs and all the infor- 
mation and data that the 5250 devices use. The SNA 
Commands and Display Data Stream Commands 
descriptions within this topic give detailed informa- 
tion about the contents of the | frames. The host 
system can send | frames to a controller that has 
responded Receiver Ready (RR). The controller can 
send | frames to the host system when it receives 
either an | frame with the P (poll of the P/F) bit on or 
a Receiver Ready command from the host system. 
Remember, the control field of the SDLC frame con- 
tains sequence count information for the | frames; the 
RU is contained in the information fields of the | 
frames. See the index entry frames for details. 


SNA Commands 


These are the commands that the host system uses to 
control the LU. Normally, these commands and 
responses are supplied by IBM. However, it is pos- 
sible for the user to affect some of these commands 
and responses; therefore, the commands and 
responses available to the user are described in 
detail in this text. The SNA commands supported by 
the controllers are: 


Actlu Reqms 
Bind Reqtest 
Cancel Rshutd 
Dactlu Signal 
Lustat Unbind 
Recfms 


SNA Session Flow and Synchronization of 5250 
Implementation of SNA in Section 1 describe the 
session types and paths these commands take. They 
also describe typical usage of these commands. The 
following text describes the individual SNA com- 
mands and responses, and details the bit meanings 
of the commands and responses that the user can 
affect. 


Activate Logical Unit (Actlu) 


This command is sent by the host system to the con- 
troller on the SS-LU expedited flow; it synchronizes 
the flow of system request data. When the host 
system receives acknowledgment of the Actlu by the 
controller, an SS-LU session is said to be estab- 
lished. 


This is the format of the Actlu command: 


Hex 
Code Meaning 


Cold activation 
ERP activation 


2 [01 —_| FMP profile, TSP profile 
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This is the format of the Actlu response: 


Maximum SS RU = 128 bytes 


RUs allowed on SS flow (display station) 
RUs not allowed on SS flow (printer) 

LU is able to process RUs 

LU is unable to process RUs, including Bind 


Note: Lustat is sent informing the SS if the !_U changes its 
available state. (See Lustat in this topic.) 


Note: When the LU becomes available, the controller issues a Lustat 0831 command on the SS/LU 
normal flow. 


The controller sends a negative response (-rsp) to the 
host system if the Actlu type is not supported. See 
the index entry negative responses for details. 
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Bind 


The Bind request is sent by the host system to the 
controller on the LU-LU expedited flow. It establishes 
an LU-LU session between the host system and the 
requested work station (LU). The controller never 
sends a Bind request. It returns either a positive or 
negative Bind response in answer to a Bind request 
from the host system; the controller returns a nega- 
tive response when there is an invalid Bind param- 
eter or invalid Bind type, or when the LU is already in 
session. 


if the Bind that the host system sends the controller is 
supported (negotiable Bind), the Model 2 or Model 12 
sends the parameters that it wants the host system to 
use in the session. The controller does not check the 
length of a Bind request. It checks only bytes 0, 1, 8, 
9, 10, and 25. The Bind request consists of 26 bytes 
of RU. The meanings of the bytes and bits that are 
checked by the controller are given in the following 
table. 


Bind Request Contents Checked by Controller 
Byte Description Code (X = Hex; B = Binary) 


0-7 
0-7 Format X’00’ supported; -rsp if not supported. 
See the index entry negative responses. 
Pacing from controller to host system 
0 Stage of pacing from controller to host system 1-stage pacing. 
= 2-stage pacing. 
1 
2-7 


Pacing count to be used when the controller is 
sending to the host system 


0-1 
2-7 Pacing count to be used when the host system is 
sending to the Model 2 or Model 12 (see Notes) 
0-7 Maximum RU size for RUs sent from the Model 2 or |Must be >X’85’ or -rsp is returned. See 
Model 12 to the host system the index entry negative responses. 
25 0-6 Reserved B’0’ = No IPL 
7 IPL B’1’ = Do IPL (5294 only) 


Notes: 

1. If byte 9 contains either 1 or 2, the controller uses the count supplied in the Bind request. If it is any other 
value, the controller sets the pacing count to 3 when received for the printer. 

2. If bits 2 through 7 of byte 9 are not 0 for the displays, the controller sends a negative response (indicating 
invalid session parameters) because the display LUs do not allow pacing of received RUs. 
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When the controller receives the Bind request from 
the host system, it issues a Bind response. The host 
system should check the Bind response to verify that 
it is compatible with the request or that it can support 
any changed parameters. 


The Bind response depends on the type of LU (type 
04 or 07) requested. The printer issues one kind of 
response and the display station another. These are 
detailed in the following table. 


Bind Response for Printer (LU Type 04) 


Code (X = Hex; 
Byte (Bits Description B = Binary) Notes 


A 


0-3 Format X’0’ 
4-7 Type x’ ——_— or ne 


FM usage Host systems send protocols. 
Chaining use Multiple RUs can be used. 
RQ mode Delayed RQ may be used. 
Chain response : RQE or RQD. 

Reserved 

Compression No compression 


Send end bracket (EB) ‘ Bind response receiver will not send 
end brackets (EB). 


FM usage Bind response sender’s send protocols. 
Chaining use ‘ Multiple RU chains can be sent. 

RQ mode : Immediate request mode. 

Chain response ( RQE or RQD. 

Reserved 

Compression f No compression. 

Send EB Bind response sender will not send EB. 


FM usage Common usage. 

Reserved 

FM headers : Not supported. 

Brackets : Reset in bracket state. 

Bracket term rule ’ Rule 1 termination. 

Code set : No alternate code supported. 
Alternate code supported. 

Reserved 
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Bind Response for Printer (LU Type 04) (continued) 


Code (X = Hex; 
Description B = Binary) 


FM usage 
FM transaction mode 
Recovery responsibility 
Contention winner/loser 
Reserved 
HDX-FF reset states 
TS usage fields 

0 Staging indicator for 5251 
Model 2 or Model 12 to host 
system direction 

1 Reserved 

2-7 
pacing count 


0-1 Reserved 
2-7 Bind request receivers 
receive pacing count 


Common usage. 

HDX-FF. 

Host system responsible for ERP. 
Bind response sender is contention 
winner. 


Bind sender reset to send. 


Echoed from Bind request. 


Echoed from Bind request. 


(Unless sent by the host system as a 1 
or 2.) 


Maximum RU sent by Bind X’85’ Inbound 256 bytes maximum. 
request receiver 

Po Maximum RU sent by Bind Outbound 256 bytes maximum. 
sender 


Staging indicator Bind RQ 
sender-receiver direction 
Reserved 


Reserved 
Bind RQ sender: receive 
pacing count 
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Echoed from Bind request. 


Echoed from Bind request. 


Bind Response for Printer (LU Type 04) (continued) 


Code (X = Hex; 
Bits Description B = Binary) Notes 
PS usage format B’0’ Basic format. 
i LU aaaieteamaaaiae B’ a LU _—— 04. 


| Bind sender’s send [Bind sender’s send capability | 


Printer data stream profile 


0 Base displacement B’1’ Base displacement supported. 
1 GSD subset B’1’ GSD subset supported. 
2-7 B’000000’ Not supported. 


en Additional media No additional media. 


Console 
Console definition 
Reserved 


FM/FMH usage field 
SS FM data B’0’ Not supported. 
FM header bits B’0000000’ No FM headers. 


afer Bind receiver’s send capabilit No send capability. 
B’1000’ EBCDIC if no alternate code. 


Code selection repertoire 
0-3 
4-7 B’0000’ No alternate code. 


ae NCI characteristics No NCI supported. 


25 0-6 B’0000000’ 
7 B’0’ 
B’1’ 
These are not returned and 
therefore are implied X’00’. 


B’0000’ 
B’0000’ 


No console. 
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Bind Response for Display (LU Type 07) 


Code (X = Hex; 
Bits Description B = Binary) Notes 


A a 


Format X’0’ 
Type X’0’ Negotiable. 


FM usage 
Chaining use 
RQ Mode 
Chain response 
Reserved 
Compression 


Send end brackets (EB) 


FM usage 

Chaining use 

RQ mode 

Chain response 
Reserved 
Compression 

Send end brackets (EB) 


FM usage 
Reserved 

FM headers 
Brackets 

Bracket term rule 
Code set 


Reserved 


Host systems send protocols. 
Multiple RUs can be sent. 
Delayed RQ may not be sent. 
RQE or RQD. 


No compression. 
Bind response receiver cannot end bracket. 


Bind response sender’s send protocols. 
Multiple chains can be sent. 

Immediate request mode. 

RQE or ROD. 


No compression. 
Bind response sender will not send end 
brackets. 


Common. 


Not supported. 

Reset in bracket state. 

Rule 1 termination. 

No alternate code supported. 
Alternate code supported. 
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Bind Response for Display (LU Type 07) (continued) 


Code (X = Hex; 
Description B = Binary) 


FM usage Common. 

FM transaction mode HDX-FF. 

Recovery responsibility ; Host system responsible for ERP. 
Contention winner/loser : Bind response sender is contention winner. 
Reserved 

HDX-FF reset states . Bind sender reset to send. 


TS usage fields 

Staging indicator for 5251 Echoed from Bind request. 
Model 2 or Model 12 to host 

system direction 

Reserved 


Bind request receiver’s send Echoed from Bind request. 
pacing count 


No pacing supported on display. 


10 0-7 Maximum RU sent by Bind X’8B5’ Inbound 256 bytes maximum. 
request receiver 

Maximum RU sent by Bind Outbound 256 bytes maximum. 
sender 


12 0 Staging indicator Bind RQ host |B’__’ Echoed from Bind request. 
to 5251 Model 2 or Model 12 
1 Reserved B’0’ 
2-7 Bind request sender’s send B’000000’ 
pacing count 
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Bind Response for Display (LU Type 07) (continued) 


Code (X = Hex; 
Byte /|Bits Description B = Binary) Notes 
13 Reserved B’00’ Same as Bind request. 
Pacing count B’XXXXXX’ 
14 PS usage format B’0’ 
- LU type B’00001 11’ LU type 07. 


i520 | |resones ik 
B’0000010’ Character display with 24 rows. 


0 
1-7 
B’000001 1’ Character display with 12 rows. 


. 6 IPL for 5294 B’0000000’ 
IPL bit B’0’ No IPL. 
B’1’ IPL. 
an These are not returned; therefore, they have the implied value 
X’00’. 


Reserved B’0’ 


Screen Size 


The following describes transmission subsystem Cancei 
profile (TSP) and function management profile (FMP) 
as referred to in the Bind command and responses, The controller sends this command to the host 
and as implemented by the controller: system on LU/LU normal flow when it is sending 
chains and it encounters an error that can affect the 
e TSP: The controller supports TSP-7, which has integrity of the data. The host system sends this 
these characteristics: command to the controller any time it wishes to pre- 
maturely end a chain; for example, the host system 
— Allows bidirectional pacing on the normal may send this in response to a negative response 
flow received from the controller. The effect of the 
— Does not allow SDT, CLEAR, RQR, and STSN command is the cessation of all RU chaining. The 
— Allows for the specification of the maximum format of the command is hex 83. The positive 
RU size for FM data in the TS usage field in response to an RQD request for this command is also 
the Bind request. hex 83. 
FMP-7 When the host system issues the Cancel command to 
the printer, the controller purges the print buffers and 
— Allows multiple RU chains issues a positive response. 
— Uses HDX-FF FM transaction mode 
— Supports these DFC functions: Cancel, See Protocols and Synchronization for 5250 Imple- 
Lustat, Rshutd, and Signal. mentation of SNA in Section 1 and index entry nega- 


tive responses for additional details. 
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Deactivate Logical Unit (Dactiu) 


This command is sent by the host system to the con- 
troller and to the printer on the SS-LU expedited flow. 
The Dactlu command terminates the SS-LU and 
LU-LU session when received by the controller. 


The code is: 


Command byte request code = hex OE; response 
code hex OE. 


Logical Unit Status (Lustat) 


This command is sent by the controller to report (1) 
the correction of a previously reported unavailable 
status of a 5250 component (hex 0001 on the SS/LU 
normal or LU/LU normal), or (2) that an unavailable 
condition for the LU has occurred (hex 0831 on the 
SS/LU normal). In addition, Lustat 0002 is also sent 
by the printer when it receives CD in the LIC or OIC of 
an RU. 


The format for the controller’s Lustat is: 


Hexadecimal 

Code Meaning 

00020200 There is no datato |LU/LU 
send (printer only). |normal 

00010000 LU was unavailable, |LU/LU 
but is available now.|normal 


LU/LU 
normal 


No-op used to 
report error 
conditions. (See the 
legend below.) 


08310000 LU not available. SS/LU 
normal 


Legend: 


This reports a parameter error 

found during a read operation. 

zz = Error code for the error 
causing the Lustat. 

03 = Resequencing error 
This reports a parameter error 
found during the processing of a 
feature field. 
zz = Error code for the error 

causing the Lustat. 

86 = Feature requested not 

installed 

87 = Self-check field greater 

than 33 bytes specified 

88 = Self-check modulus 

specified but not 
supported 


yy = 01 


Any Lustat issued by the host system is unexpected; 
the controller will supply a positive response. The 
controller must have the CD on to send the Lustat on 
the LU/LU normal flow. 
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Record Formatted Maintenance Statistics (Recfms) 


This command is concerned with the error log. 
Recfms can be either a solicited or an unsolicited 
command. This command can only be sent by the 
controller on the SS/PU normal flow. 


Solicited Recfms: When there is no overflow condi- 
tion and the host system wants the error log, the host 
system sends the Reqms command to the controller. 
This requests immediate sending of the error log to 
the host system. The controller immediately sends 
the error log contents via the Recfms command. 

(See the index entries errors, error log.) 


Unsolicited Recfms: When an overflow condition 
exists, the controller immediately sends the Recfms 
command to the host system. It does this by prefixing 
the Recfms command to the error log data. 


Note: Remember that the error log is cleared when 
unsolicited Recfms or solicited Recfms are used and 
Reqms byte 7 bit 0 = 1. 


If byte 7 of the Reqms command has bit 0 = 0, the 
error log is not cleared. If the host system does not 
have a buffer allocated to collect the contents of the 
error log, valuable information for diagnostic mainte- 
nance could be lost. 


The format of the Recfms command is: 


Hex 

Code _ |Description 

4 Network services 
(physical services) 


Request code 


Set to 0 


1 
03 
84 


0 = log overflow 1 = 
sent in reply to Reqms 
B’0000100’ 


XID data 


FF Log segment 
Error statistics 


The response format consists of bytes 0 through 2 in 
this chart. 
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wt 


Request Maintenance Statistics (Reqms) 
This command is concerned with the error log and 
can only be received by the 5294 during SS/PU 


normal flow. 


The format of the Reqms command is: 


Bye [BH [HexCode [Description 

PT fem 
(physical services) 

i _| |e [Maintenance services 

Cs 


pa || dren 


Request Test Procedure (Reatest) 


Whenever the operator keys the test request 
sequence (see the index entry test request keys), the 
controller sends the following Reqtest command to 
the host system: 


Hex 
Code Description 


p [or [Networcsersees 
ite [Maitenancesevices 
p [eo [Reaves cove est) 
bo _[networknames 
too networcname 2 
5 foo |rreceaure name 
@ foo |reavenerid 
7 oo |rasewors 
Cn 


Normally, the host system sends back a test menu in 
response to this command. This menu allows the 
operator to determine which tests to use. The 
Reqtest command is sent in the SS-LU normal flow as 
formatted, FM, nonexpedited data with RQD speci- 
fied. 


Note: The controller does not support receiving this 
command from the host system. 


Request Shutdown (Rshutd) 


Because the controller has sensed a hardware error, 
it sends the Rshutd command to terminate the LU-LU 
session. This command is sent on the LU/LU expe- 
dited flow; it is followed by Lustat hex 08310000 to 
indicate that this LU is not available. The host 
system should respond to this command by sending 
an Unbind command. The error log contains explan- 
atory information (See the index entry errors, error 
log.) The user can access this information by using 
the Reqms command. See the index entry reqms 
command. The controller does not support receiving 
an Rshutd command from the host system. The 
command Code is hex C2. 
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Signal 


The Signal command is an expedited means of 
alerting session partners of an occurrence or request 
that needs attention. This command is sent on the 
LU/LU expedited flow. Some examples of such 
occurrences or requests follow: 


e The receiving partner wishes to send data. The 
operator presses the Attn key and the controller 
issues a Signal command to the host system. 


¢ Intervention is required for the printer. For 
example, the printer has no forms left for 
printing. The controller sends the host system a 
Signal command. 


e A previous condition that required intervention 
has been cleared. For example, forms have been 
loaded into the printer. The 5251 controller sends 
the host system a Signal command. 


e The operator requires assistance in an error 
state, so the operator presses the Help key. The 
controller sends the host system a Signal 
command. 


e The Message Waiting indicator needs to be 
turned on or off. The host system sends the con- 
troller a Signal command. 


The format for the Signal command is: 


ee 


00 010001 |Request to send (Attn 
key pressed on the 
display station). 

Printer intervention 
required (for xx 
descriptions, see the 
following charts). 
Component now 
available (operator has 
cleared the error on the 
printer). 

Signal operator (turns 
on the Message 
Waiting indicator and 
sounds the Audible 
Alarm). 

Resets the Message 
Waiting indicator. 
Signal help code. 

yyyy is 4 digits of 
packed decimal code 
indicating either (1) 
operator error or (2) 
information sent by a 
previous Write Error 
Code command. See 
index entry operator 
error codes. 


00 03 02 xx 


00 00 00 02 


00 00 00 01 


00 00 00 05 


00 02 yy yy 
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§224/5225 Printer 
Graphic check 


30 Reserved 


GO 


m 


1 Control and-sense card Y 


es 
st |Resewes | 
Pedestal 

b_[Ribboncars ies 


Oo} @ 


Y 
Y 
50 
51 
81 Y 
82 
83 Y 
Y 
85 


es 
es 
es 
es 
es 
Yes 
Yes 
Yes 


~] 


28 __[eraphiceror «dN 
30 | Printer mechanism not ready 


3 |Fastepeed check ——ives 
flagged 
fo _[Erottorms id 


51 Printer not ready and not 
available 


Unbind 


The host system sends this command to the con- 
troller on the LU-LU expedited flow; this command 
terminates the LU-LU session. The controller accepts 
and executes any valid Unbind command when the 
LU is in an LU-LU session. The result of this 
command is that all LU-LU session parameters and 
SNA states are reset. The controller sends the host 
system a positive response and hex 32 to indicate to 
the host system that the command execution is com- 
plete. 


The format of the Unbind command is: 


Byte 0 
Byte 1 


Unbind code (hex 32) 
Status (See note.) 


Note: Any status code is acceptable here. 
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Transmission Commands 


The controller implements the transmission protocol 
and command set to drive the attached LUs. These 

are transparent to the user; therefore, this text does 
not include details about transmission commands or 
responses. 


Common Carrier Services 


Communications services are provided throughout 
the U.S.A. and in other countries by privately owned 
(but government regulated) companies. In other 
countries, the services may be provided by the gov- 
ernment and are usually referred to as post telegraph 
telephones (PTTs). 


Domestic Services 


Nonswitched Voice Grade Communication Lines 
(3002 Channel Equivalent) and Nonswitched Metallic 
Lines 


These lines may operate at speeds up to and 
including 19.2K bps using IBM- or OEM-supplied 
modems. The actual operating speed is determined 
by the modem used and the line type and quality 
available. 


e IBM 1200, 2400, or 4800 bps integrated modems 
for the 5251 Models 2 or 12 and IBM 3863, 3864, 
3865, and 3872 external modems operate ona 
Type 3002 basic channel. See note. 


e IBM 3874 (4800 bps) modems operate on a Type 
3002 channel with C-1 conditioning. 


e IBM 3875 (7200 bps) modems operate on a Type 
3002 channel with C-2 conditioning. 


¢ OEM modems that are compatible with the 5251 
Models 2 and 12 may operate at speeds of up to 
9600 bps on a 3002 channel with conditioning as 
required by the modem. The 5294 Control Unit 
operates from 2400 bps to 19.2K bps. 


Note: In some cases, the IBM 3865 may require a 
Type 3002 channel with D-1 conditioning for the 


1 Trademark of the American Telephone & Telegraph Co. 


Model 1 and D-2 conditioning for the Model 2. Check 
with your modem supplier for details. 


X.21 Public Data Networks 


These lines operate at speeds of 2400 to 48,000 bps 
and are connected to the 5294 Control Unit with the 
X.21 Adapter feature. These lines can be circuit 
switched or nonswitched. 


Common Carrier Switched Telephone Network 


These lines may operate at speeds of up to 9600 bps. 
The line speed is determined by the modems and the 
network used. 


AT&T’s Private Line Data-Phone Digital Service’ 


These lines operate at 2400, 4800, or 9600 bps and 
connect to a system or 5251 Models 2 or 12, and up to 
56,000 bps for the 5294 via an AT&T Channel Service 
Unit or Data Service Unit. 


World Trade Common Carrier Services 
Nonswitched Voice Grade Communication Lines 


These lines operate at speeds of up to and including 
9600 bps. However, most post telegraph telephones 
(PTTs) do not provide services equivalent to the 3002 
channel, with its various types of conditioning which 
is available in the United States. The type of line 
used depends on the modem chosen and is either a 
Normal Quality Line designated Type M.1040 (for 
international service) or a Special Quality Line Type 
M.102 (for international service Type M.1020). 


The selection of modems and operating speeds may 
be limited by PTT rules and regulations or by line 
types available. 


Common Carrier Switched Telephone Network 
These lines operate at speeds of up to 4800 bps for 
the 5251 Models 2 or 12 and up to 9600 bps for the 
5294, and use IBM, OEM, or PTT modems. PTT 


modems are mandatory in some countries. 


The selection of modems and/or operating speeds or 
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network types may be limited by PTT rules and regu- 
lations or by line types available. 


5294 Communications 
Features 


The 5294 Control Unit must have one of the following 
communications features installed to operate ona 
communications network. 


e EIA/CCITT Interface Adapter 
e XLCA Adapter 
e Digital Interface Adapter. 


The configuration and other communications controls 
for these features are described in the /BM 5294 
Setup Procedures manual. All of the communications 
features for the 5294 can be field installed by service 
personnel. The following topics briefly discuss the 
communications features for the 5294. Detailed infor- 
mation on the 5294 communications is contained in 
this section, organized alphabetically by topic. 


EIA/CCITT Interface Adapter 


This feature is required to connect the 5294 Control 
Unit to external data circuit-terminating equipment 
(DCE). The adapter interfaces to a synchronous DCE 
which complies with the electrical/physical criteria of 
RS232C and CCITT Recommendations V.24/V.28 (This 
adapter is also used for X.21 bis DCE). With this 
adapter, the 5294 supports communications speeds of 
2400 bps through 19.2K bps. For countries other than 
the U.S.A., a Primary/Secondary Line Speed switch is 
provided to enable half-speed operations. 


XLCA Adapter 


The XLCA Adapter feature allows the 5294 to attach 
to the following: 


e  X.21 Public Data Network 
e  X.25 Packet Switching Network. 


This adapter provides interface circuits and electrical 
characteristics described in CCITT Recommendation 
X.24/X.27 (V.11) and operates as described in CCITT 
Recommendation X.21. With this adapter, the 5294 
can operate from 2400 bps up to 48,000 bps. 


Digital Data Service Adapter (DDSA) 


The DDSA allows the 5294 to attach to the AT&T 
Private Line Data-Phone Digital Service Network. The 
adapter enables connection to the AT&T Channel 
Service Unit or equivalent. With this adapter, the 
5294 can operate up to 56,000 bps. 
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Communications Network Errors 


If a network error occurs while a display station is being used, the keyboard locks and a 4-digit error code is 
displayed. The error codes and a brief description of each error are contained in the following list. The type of 
network the error applies to is shown in the right column (Y=yes, N=no). For complete instructions on recovery 
and problem determination, see the Operator’s Guide for the appropriate device. 


SDLC SDLC 
Error Code |Meaning Switched |Nonswitched 
0040 The modem/DCE is not ready when expected Y Y Y Y 
to be ready. 
0041 The ‘received’ line was idle for 15 contiguous Y 
bit times. 
0042 A failure occurred in the receive clock signal Y Y Y Y 
during a receive operation. 
0043 The modem/DCE is ready when expected to be Y 
not ready. 
0044 The 30-second time out ended with no valid data 
received. The controller will terminate the call. 
0045 The network will not activate. Either a 


disconnect mode (DM) or a disconnect signal 
(DISC) was received during link setup procedures. 


004s =| The 5294 received an invalid X.25 frame. 


ete 5294 received an unexpected disconnect 
mode (DM) or a disconnect (DISC) signal. 


Either the clear to send line was inactive while 
the request to send line was active, or the clear 
to send line was active while the request to send 
line was inactive. 


0051 The transmit clock failed during a transmit Y Y Y Y 
Operation. 

0052 The transmit buffer failed to clear either before 
or during a transmit operation. 


0053 INo acknowledgment of a transmission was 
received before the T1 timer expired after the 
tenth retry attempt. 


The communications cable was unplugged 
and plugged back in, or the DCE was powered 
off then back on, or the X.21 attachment 

feature detected an error. 
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Control Characters 


This topic includes two types of control characters 
(CC): control characters for the display and control 
characters for the printer. The display control char- 
acters are used in some of the display LU-LU com- 
mands to allow the user to determine the 
characteristics of the display. The printer control 
characters, which are an SNA subset called standard 
character string (SCS), are in the printer output data 
stream; they allow the user to determine the format 
of the printed output. Although both are called 
control characters, they share no function and have 
no relationship. 


Display 


The display CCs are always used as 2-byte (2-CC) 
fields. They appear in the Write to Display, Read 
MDT Fields, and Read Input Fields commands in the 
display’s output data stream (see the index entry 
display, commands). These characters select the 
specific operations for the display station to perform. 
Byte 1 is always processed first. When the CCs are 
used with the Write to Display command, the first CC 
is processed immediately while the second CC is not 
processed until all the other information associated 
with the command has been processed. The fol- 
lowing gives the format and bit information for these 
2 bytes: 


First Byte 


ts |Reset Pending Aid; |Reset MDT Flags in Reset MDT Flags in (Fields with MDT /|Null All Nonbypass 
Nonbypass Fields All Fields 


_ Clear Master MDT; Clear Master MDT; /|Null Nonbypass 
Bi 


1. Bits 3 through 7 are reserved and should be set to 0. 
2. If there are no bypass fields with MDT flags on, then the master MDT will be cleared. 
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Second Byte 


Meaning 
Reserved. 
Reserved. 


No action. 


Reset blinking cursor (Note 1). 


No action. 


Set blinking cursor (Note 1). 


No action. 


Unlock the keyboard and reset any pending aid bytes (Note 2). 


No action. 


Sound alarm. 


No action. 


Set Message Waiting indicator off (Note 3). 


No action. 


Set Message Waiting indicator on (Note 3). 


. If bits 2 and 3 are both on, the cursor blinks. For the 5292 Color Display Station, bits 2 and 3 will 
be effective only if the operator does not use the blink cursor function. See the index entry 
select option mode keys. 

. If the keyboard is already unlocked, this bit is ignored; otherwise, it: 

a. Unlocks the keyboard. 

b. Turns the keyboard clicker on. 

c. Turns the Input Inhibited indicator off. 

d. Moves the cursor to the address given in the last IC order (see the index entry /C order) or 
defaults to the first position of the first nonbypass input field if no IC order has been given. 
If there is no nonbypass field, it defaults to row 1, column 1. 

e. Clears all unserviced aid requests. 

. If bits 6 and 7 are both on, the Message Waiting indicator is set on. 
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Printer 


The SNA subset support for the 5219, 5224, 5225, and 
5256 printers is accomplished through standard char- 
acter string (SCS) control characters. The user codes 
these control characters in the printer output data 
stream. SCS control character codes (00-3F) not 
recognized by the printer set invalid SCS control 
character status. See the index entry data streams. 
Printer Data Stream Example in Section 1 shows a 
sample printer data stream. The following chart 
describes the general functions provided by the 
printer control characters. A detailed description of 
each control character follows the chart. 


The IBM 4224 Printer does not support SCS codes, 
but does support IPDS codes. Refer to the /BM 4224 


Printer Product and Programming Description, 
GC31-2551, for more details. 


SCS Control 

Character and Code |Description 

PP (34xxnn) Identifies the next print position, either horizontal or vertical, as 
defined by xx. 


34COnn Horizontally moves the print position to the position defined by 
nn. 
Relative 34C8nn Horizontally moves the print position nn print positions away 
from the present print position. 
Vertical: absolute 34C4nn Vertically moves the paper to the line specified by nn. 


Relative 344Cnn Vertically moves the paper nn lines from its present position 


Maximum print position |Fmt (2Bxxnn__) Defines either the maximum horizontal or vertical print postion 
as specified by xx. 

Horizontal 2BC1nnhh sets the maximum horizontal print position where nn = the 
number of bytes in the string and hh = the maximum horizontal 
print position. 

Vertical 2BC2nnvv 


SGEA (2BCnngguu) 


Sets the maximum vertical print position where nn = the 
number of bytes in the string and vv = the maximum vertical 
print position. 


Define the unprintable 
Character 


Sets the unprintable character option and defines the default 
character where nn = the number of bytes in the string, gg = 
the default graphic, and uu = the print option. See the index 

entry SGEA CC. 
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Logically moves the print position to the first position of the 
next line. 
Same as NL. 


Logically moves the print position vertically to the same 
horizontal print position of the next line. 

Moves the print position to the first position of the next 
logical page. 


Move the print position |CR Logically moves the print position to the first position of the 
(OD) same line. 

No operation NUL 
(00) 


Stop printing and alert Turns off the Ready indicator and turns on the Attn indicator, 


operator sounds the Audible Alarm (if installed), and stops 
printing. 


Transparent Permits the codes normally used as control characters to be 

(5224 and 5225) used as printable characters. The parameter frame nn 
specifies the number of frames that follow the 35-command 
frame. 


Set Character SCD Sets the character density to 10 or 15 characters per inch as 
Density (5224 and 5225) |(2BD20429P1P2) specified by the P1 and P2 parameter frames. 

Set CGCS through SCL Loads 1 of 16 graphic character sets specified in the P1 
Local ID (5224 and 5225) |(2BD10381P1) parameter frame. 


Load Alternate LAC Allows user-designed fonts or characters to be loaded 
Characters (5224 and (2BFEnn01 for printing. 
5225) EEI111e) 


Set Line Density SLD Selects vertical line density of 6 or 8 lines per inch or other 
(5224 and 5225) (2BC6nnLD) densities in multiples of 1/72 of an inch. 
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BEL 

Function: This control character stops printing, 
sounds the Audible Alarm, if installed, and turns on 
the Attention indicator. 


Code: Hex 2F 


Results: When the printer microprocessor detects 
this control character, it: 


e Allows all preceding data to be printed and all 
preceding control characters to be executed 


e Turns the Ready indicator off 

e Turns the Attention indicator on 

e Sounds the audible alarm, if installed 
e Stops printing 

e Stops formatting 


e Returns an unavailable status to the 5251 Model 2 
or Model 12. 


Carrier Return (CR) 


Function: This control character performs a carrier 
return to the first print position on the same line. 


Code: Hex 0D 


Results: The horizontal print position logically 
moves to the first print position on the same line. If it 
already is at the first print position, no operation 
occurs. 


Forms Feed (FF) 

Function: This control character moves the paper to 
the next logical page as specified by the Set Vertical 
Format control character (see Fmt in this topic). 
Default: 1 logical page = 1 logical line. 


Code: Hex 0C 


Results: The print position moves to the first logical 
print line and first logical print position of the next 
logical page. 


Format (Fmt) 
Function: This control character defines data format- 
ting for a specified length (provided in the param- 


eter). 


Default: Logical line length = 132 character posi- 
tions; logical page length = 1 line. 


Code and Format: 


Associated 
Code Set Type Parameters 


Start of formatted |Length of formatted 


data stream. Must |data stream. 
include: SHF, 
SVF, or SGEA 


Results: The following chart shows the various set 
types and their associated parameters. 
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Set Types Available for Use with the Format (Fmt) Printer Control Character > 


Set Type Format Values of Parameters Description of Set Type 


SHF (Set 2BCinnhh |nn = Number of bytes in the SHF 
Horizontal string. 
Format) 
Maximum horizontal print Sets the maximum print position (MPP), 
position (greater than or equal _ |which is the value of the print line length. 
to 1 and less than or equal to 
132); the default is 132. 
If a 00 is sent, the printer 
substitutes its largest maximum 
print position which is 132 for 
the 5256 and the 10 character 
per inch density of the 5225, 
and substitutes 198 for the 15 
characters per inch density of 
the 5225. 


2BC2nnvv Number of bytes in the SVF 
string. 


Maximum number of lines ona_ |Sets the maximum print line (MPL) on the 

page greater than or equal to 1 |logical page; it overrides the physical device 

and less than or equal to 255. logical page. 

The default is a page length of J 
one line. 
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Set Types Available for Use with the Format (Fmt) Printer Control Character (continued) 


Set Type Format Values of Parameters Description of Set Type 


2BC8nnggxx Number of bytes in the SGEA 
string. 


Input Hex Data Stream? 5256 Results 


Unprintable Unprintable 
Character Character 
Option uu Error Status 


Invalid’°SCS 
parameter 


Invalid SCS 
parameter 
Invalid SCS 
parameter 


If GG is unprintable, including characters in the EBCDIC control code quadrant, a 
hyphen is printed. 

The first 2 characters (the first byte) in the hex data stream are control characters; 
if unspecified ones are used, an error code 28 results. The characters to the 

right of the control characters are control parameters; if unspecified ones are 
used, an error code 29 results. 


gg = Unprintable character option. Sets the way the printer will respond when 
Note: On early production it encounters an unacceptable symbol 
5256 printers, options 02 and in the data stream. 
04 will allow printing of the Note: nn must be at least 1 and not greater 
International Extension than 3 for the SGEA set type. 
characters. See Figure 2-3. 
01 = No stop, no status. 
02 = Defaults to 01. 
03 = Stop, hard error status. 
Unit not available 
04 = Defaults to 03. 
The default for xx is 01. 
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The following chart shows the characteristics of the 
SHF and SVF set types: 


Valid Values for the SHF and SVF Set Types 


nn 


00 MPP = 132 Invalid SCS parameter 
nn = 01 MPP = 132 None 


nn = 02 MPP = 132 None 
hh = 00 MPP = 198* 


nn = 02 MPP = 1-132 as specified 
hh = 1-84 


hh = 85-C6 MPP = 133-198 as specified” 


nn = 02 MPP = 132 Invalid SCS parameter 
hh = 85-FF 


nn = O3FF Invalid SCS parameter 


Invalid SCS parameter 


Invalid SCS parameter 


*A maximum print position of greater than 132 is only possible on the 5224 or 5225 printer when a print 
density of 15 characters per inch has been set prior to the execution of this command. 


2-46 IBM 5250 Information Display System Functions Reference Manual 


Interchange Record Separator (IRS) 


Function: This control character does the same thing 
that NL does. 


Code: Hex 1E 
Line Feed (LF) 


Function: This control character moves the paper 
one line without altering the print position. 


Code: Hex 25 


Results: Moves the paper logically to the same print 
position on the following line. If you use this control 
character on the last line of a page, it will move the 
print position to the first line of the next page. 


New Line (NL) 


Function: This control character moves the paper to 
the next line. 


Code: Hex 15 


Results: The print position moves to the first print 
position on the nexi line if it is not coded on the last 
line of the page. If you code this on the last line, it 
moves the paper to the first print position on the first 
line of the next page. 


NUL 
Function: No-op 
Code: Hex 00 


Results: No characters are printed and no functions 
are performed. 


Print Position (PP) 


Function: This control character moves the logical 
print position as determined by the associated 
parameters. 


Restrictions: The absolute parameters must be 
equal to or less than the page length. (See the fol- 
lowing explanation.) If the absolute horizontal 
parameter is less than the current print position, the 
printer microprocessor treats it as a separate line 
and inserts a CR control character in the printer data 
stream. If the absolute vertical parameter is less 
than the current line number, the microprocessor 
treats it as a new page. If both are equal, no opera- 
tion is performed. Relative values must indicate a 
move to but not past the end of the line or page. A 
value of 0 is not valid, and no operation is performed. 


Code and Format: 


Hex 34 Function Parameter Value Parameter 
(hex) (decimal) 


(See Note 1.) (See Note 2.) 


The results are determined by the parameters as 
described in the following notes: 


Notes: 


1. The following chart shows the types of moves 
available and indicates what the PP CC accom- 
plishes for each type: 


Function 
Parameter 
(Hex) Value Parameter (Decimal) 


Absolute |CO Numeric value of horizontal 
horizontal position (less than or equal to 
move the end of the line). 

Absolute |C4 Numeric value of vertical 
vertical position (less than or equal to 
move the end of page). 


Relative |C8& Numeric value or horizontal 

horizontal movement from the present 
position (less than or equal to 
the end of the line). 


Numeric value of vertical 
movement from the present 
position (less than or equal to 
the end of the page). 
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2. The following chart shows the relationships of the 
parameters: 


Parameter Relationships 


Absolute horizontal move |00 

(hex 34COnn) 
00 <nn< 132 (10 cpi) 
00 < nn< 198 (15 cpi) 
nn>maxPP 


Absolute vertical move 00 
(hex 34C4nn) 


current PP <nn<max PP 
Q<nn<current PP 


nn>max PP 


Relative horizontal move |00 
(hex 34C8nn) 
nn+current PP < max PP 


nn+current PP >maxPP 


|Relative vertical move 00 
(hex 344Cnn) 
nn+current PP <max PP 


nn+current PP > max PP 


Set Horizontal Format 
2B(C1nnhh) 


Set Vertical Format 
2B(C2nnvv) 
(vv) 1<vv<255 


00 


No-op; the current print position is unchanged; no 
error. 
The print position becomes the value of nn. 


Error; invalid SCS parameter. 


No-op; the current print position is unchanged; no 
error. 

The print position becomes the value of nn and 
remains on the same logical page. 

The print position becomes the value of nn and goes 
to the next logical page. 

Error; invalid SCS parameter. 


No-op; the current print position is unchanged; no 
error. 

The new print position is equal to the current print 
position plus the value of nn. 

Error; invalid SCS parameter. 


No-op; the current print position is unchanged; no 
error. 

The print position becomes the value of the current 
print position plus the value of nn. 

Error; invalid SCS parameter. 


Total number of frames following the command 
(including the count frame) is defined. 

The maximum print position is set at a value between 
1 and 198. 


No-op, the default value of hex 84 (132) is supplied. 
Error; invalid SCS parameter. 


Number of frames to end of SVF string (including the 
count frame) is defined. 

Sets the value of the maximum number of print lines 
per page. 

The function retains the default value of one line. 
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C 


Parameter Relationships 


SGEA (Set Graphic Error |(nn) Number of frames to the end of the SGEA string 
Action) 2B(C8nnggxx) 01, 02, 03 (including the count frame) is defined. 

(gg) Substitutes a designated graphic character for any 
unprintable characters encountered. If the graphic 
character selected is also unprintable or if no character 
is designated, the default character is a hyphen. 

(uu) Determines error and status action resulting from an 

If SGEA has not been unprintable character as follows: 

sent, the default is: Hex 01 = no stop, no status 

hex 01 (no stop, no status) |Hex 00 = default to hex 01 

Hyphen in place of any Hex 02 = default to hex 01 

unprintable character. Hex 03 = stop, hard error status 
Hex 04 = default to hex 03 


TRN (Transparent)! (35nn)j (nn) Permits codes normally used as control characters to 
01<nn<255 be used as printable characters. 
00 Number of frames of transparent data to follow (not 
Use of the codes hex 00 _—_—sifincluding count frame) is defined. 
through hex 3F requires |No-op; following data is treated as normal data. 
that print images for those 
values have been loaded 
into the 5224 or 5225 print 
buffers by the using 
system. If no image was 
loaded for a given code, 
the 5224 or 5225 inserts a 
blank. 


SCD (Set Character (on) Defines the number of characters per inch to be printed. 
Distance)' P2 = 0A (10 cpi) 
2B(D20429P 1P2) OF (15 cpi) 
00 (no-op) 
FF (default to 10 cpi)|Error; invalid SCS parameter. 
P2 = OA, OF, 00, or FF 


SCL (Set CGSC through _|(P1) Selects 1 of 16 predetermined character sets used to 

Local ID)' P1 = FF or 00<p1<OF print data. These character sets are designated by a 

2B(D10381P1) Code (P1). FF sets printer to default (jumper setting) 
character set. 


LAC (Load Alternate (nn) = 10x +2 Allows loading of from 1 to 25 character images into 
Character(s)) nn<252 the alternate character buffer. 
(2BFEnn01EE11118)' EE = code point where 

character is to be placed. 

11 through 118 = 9 bytes 

making up the character. 


SLD (Set Line Density) nn = count byte Allows 6 or 8 lines per inch. 
2BC6nnLD) LD = number of 1/72 inch 
forms movement per line 


| |'Applies to the 5224 and 5225 Printers only. 
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Copy to Printer Feature 


This feature allows the user to print the contents of 
the display using any printer that is attached via a 
cluster feature. When the feature is installed, the 
host system sends the Copy to Printer command to 
the controller in the following format: 


ESC Copy to Printer 
Character Printer LSID (See 
Hex 04 Command the index of Lines End 
Hex 16 entry on Page 
addresses.) (See Note.) 


Maximum SNA 
Number Chain 


Note: The default for this is the same number of print 
lines per page as there are lines in a display. If 00 is 
specified, the default is to the display size. 


The Copy to Printer command must be LIC or OIC on 
the RU, or followed by null RUs. 


The operator should ensure that the printer is posi- 
tioned at the first print position on a new page when 
issuing this command. The format of the data stream 
as it is created and sent by the controller to the 
printer is the printer control character with the hori- 
zontal control set to the display line length, and the 
vertical controls set to the maximum print line. (See 
the index entry contro/ characters, printer for specific 
details about the types of characters that control 
these formats.) 


The results of using the Copy to Printer feature are: 
e All nondisplay fields are printed as blanks. 

e All null characters are printed as blanks. 

e All screen attributes are printed as blanks. 


e All dup characters are printed as an overstruck 
asterisk. 


e Blank lines on the display are translated to new 
lines at the printer. 


e A form-feed control CC is appended to the end of 
the data stream to position the printer at the top 
of the next page. 


The terminal returns a positive response when it 
completes this command. The operator can cancel 
this command from either the keyboard or the printer. 
To cancel the operation from the keyboard, the oper- 
ator first presses a shift key and then the Print key. 
This terminates the operation without alerting the 
host system that an abnormal termination has 
occurred (normal +rsp). To terminate the operation 
from the printer, the operator sets the Status switch 
to the Cancel position. The controller then sends a 
negative response to the host system, indicating that 
an abnormal termination has occurred. The following 
conditions result in the terminal responding to the 
command with a negative response: 


e Another command is outstanding for the printer. 
e The printer is involved in an LU-LU session. 

e There is an error condition. 

e Status switch is set to Cancel on the printer. 

e Anincorrect LSID has been specified. 

e An RU error exists. 


e Intervention is required to make the printer 
ready. 


Note: See the index entry negative responses. 


Data Streams 


The data streams consist of all the information 
required by the controller to drive the attached work 
stations (LUs), and all of the response information 
that was furnished by the LUs and sent to the host 
system by the controller. The 5250 display and 
printer data streams reside in the SNA RUs which are 
embedded in the | part of the SDLC | frames. See the 
index entries frames and RU for details about these 
subjects. If you are not familiar with SNA, please 
read the information under Protoco/s and Synchroni- 
zation for 5250 Implementation of SNA in Section 1 of 
this manual. 
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Display 


The display data stream is on the normal FMD LU-LU 
flow in SNA RUs; it contains (1) commands, data, 
orders, and parameters that the host system uses to 
control the display and (2) data and status informa- 
tion that the 5251 Model 2 or Model 12 sends the host 
system in response to the host system’s requests. 
See the index entries display, commands, and 
orders. The general format of the output display data 
stream is: 


ESC Command 
Hex 04 


ESC or SNA 
Chain End 


Associated 
Parameter 


The general format of the data stream that the 5251 
Model 2 or Model 12 sends to the host system for the 
display is: 
Cursor Address Aid Code 
(2 bytes) 


Field Data 


Note: See the index entries aid codes and input com- 
mands. 


Printer 


The data stream for the printer contains a mixture of 
output data to be printed and control characters that 
direct the printer to format the data as the user has 
specified. See the index entry contro/ characters, 
printer for details about these topics. The printer 
data stream comes in the normal FMD LU-LU flow 
path in SNA RUs. The format for the printer data 
stream looks like this: 

CC Data CC Data CC Data 
The host system writes information to the printer by 
issuing the printer data stream. There are no printer 
commands. The Copy to Printer feature is executed 
by issuing a command to the display. See the index 
entry copy to printer feature for detaits. 


Digital Data Service Adapter 


This special feature allows the 5251 Model 2 or Mode 
12 and the 5294 to attach to AT&T’s Private Line Data 
Phone Digital Service (or equivalent) through the use 
of an AT&T Channel Service Unit (or equivalent). The 
data rates are 2400, 4800, or 9600 bps for the 5251 
Model 2 or Model 12 and up to 56,000 for the 5294. 


The 5251 Model 2 or Model 12 can also be directly 
attached to some systems using the Digital Data 
Service Adapter (DDSA) feature. The host system 
must be equipped with a communications adapter 
and a DDSA feature. To determine if a 5251 Model 2 
or Model 12 can be directly attached to your system, 
contact your IBM sales representative. The 5294 
cannot be directly attached. 


EBCDIC Character Sets 


Figure 2-1 applies to the 5251 Models 1, 2, 11, or 12, 
the 5252, the 5291, and the 5292 display stations 
equipped with the 96-Character EBCDIC character 
set. This character set is standard on all display 
stations and contains all characters of the ASCII char- 
acter set, but not necessarily in the same positions. 
Hexadecimal combinations for which no characters 
are shown may have unpredictable results that vary 
with the level of the machine. Figure 2-2 shows the 
Katakana character set. Figure 2-3 shows the char- 
acter sets for major countries. 


Also available is the Multinational character set. 
This character set allows you to generate any 
EBCDIC character that is not available on your key- 
board but is needed for input and displaying. For 
more information about the Multinational character 
set, see Multinational Character Set in this section. 


Note: Unless otherwise specified, characters in the 
following character sets are printed as displayed. 


The character that has a heavy line surrounding it is 
printable only on early production 5256 printers when 
option 02 or option 04 of the Set Graphic Error Action 
has been set. 
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The Set Graphic Error Action control character (see 
the index entry CC, printer) can be set to do one of 
the following when an unprintable character is 


encountered: 

01: Continue printing without an error; a default 03: Finish printing the current line, supplying a 
character will be substituted for any unprintable default character for the unprintable 
characters. character(s), and post an error. 

02: Defaults to 01. 04: Defaults to 03. 

First Hexadecimal Character 

Second 

Chereceer | °,1|2/3| 4] s/6[7| 8 ]9 [ale lc [ole |e 

Character 


ep es ee 
=P 
pt tT Tt Ty fs fi fey fafa fa 


Note: Variable; see the appropriate chart for the specific characters for your country. 


Figure 2-1. EBCDIC Character Sets (96-Character EBCDIC Character Set) 
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Figure 2-2 shows the Katakana character set. 


The character that has a heavy line surrounding it is not printable and cannot be entered from the keyboard, but 


will be displayed if the corresponding hexadecimal code is received as data from the host system. 


Katakana 
Second First Hexadecimal Character 
Hexadecimal 
aoe Se 


Cs EAE ce Tefele ts 


ROARS CRC UE 
eee 


Figure 2-2. EBCDIC Character Set 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the ) 
set Graphic Error Action control character or, if unspecified, by a hyphen. | 


Ausiria/Germany 
First Hexadecimal Character 


Second 
Hexadecimal 
Character 


Note: 


Dependent on the display station/printer you are using, see the following table: 


Character 


Display Printer 
5292, 3179, 3180, 5224, 5225, 4214, 5262, j / 
and 3196 4214, 4224, and 4210 y 1 
5251, Models 1, 2 


Figure 2-3 (Part 1 of 11). EBCDIC Character Set 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


First Hexadecimal Character 


Second 
Hexadecimal 
Character 

Note: 


Dependent on the display station/printer you are using, see the following table: 


5251, Models 1, 2 
11, 12, and 5252 


Figure 2-3 (Part 2 of 11). EBCDIC Character Set 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


Canadian French 


First Hexadecimal Character 


Second 

Hexadecimal 1 2 3 7 A C F 

Character 
co] | | fmlel-felol- | ele] efel se 
ty ty feel fefel il fe zs 
2] | | | felelalejel x] s/¥| es] ks] 2 
DESO onn Doone 
DESSenOnoooMeaOce 
DESEO OeOGC. 
el ape wie [oll 
7{ [| | ai falifele[x[xfele| x 7 
et TT | felted {Hlaly|s 
co] | | fafeia sili elaf{ifa zs 
CaP ORnaSehee.we 
ce] | | | fets].la#{>felel i efelo ¢ 
ce] [+] | <[-|*/@lefe oi salou 
po} TT | feta]: pms [el Pea f ole 
et | | | feet >| -[efelp flo 
FL | | tf yetey pep opel el els 

Note: 


Dependent on the display station/printer you are using, see the following table: 


Character 


Display Printer 
Station 


5224, 5225, 5262, 
4214, 4224, and 4210 


5251, Models 1, 2 
11, 12, and 5252 


Figure 2-3 (Part 3 of 11). EBCDIC Character Set 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


Second 
Hexadecimal 
Character 


Note: 


Denmark/Norway 


wu 


First Hexadecimal Character 


bebe et fete eee eek eee 


Bnangonoed 


as 


RIES 


ifel-lelrle 


Dependent on the display station/printer you are using, see the following table: 


Display 
Station 


5292, 3179, 3180, 
and 3196 


5251, Models 1, 2 
11, 12, and 5252 
3180 and 3198 


Pri tee 
5224, 5225, 5262, 
4214, 4224, and 4210 


Figure 2-3 (Part 4 of 11). 


4 


EBCDIC Character Set 


| ofw 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


Finland/Sweden 


First Hexadecimal Character 


Second 
Hexadecimal 
Character 


1c) 


ae SOODGnOCORDCER 


me) eS Le el 
Boe 
Ey 
a 
me 
RN 
Es 
ce 


Note 
SORREROCOAC were 
Pepa ted Ele tad hep 
Cee OOReoOsScooe 


Dependent on the display station/printer you are using, see the following table: 


Note: 


Character 
Display Printer 
Seay | Pree | a0 | ap| ac | om 
5292, 3179, 3180, 5224, 5225, 5262, ; ‘ 
and 3196 4214, 4224, and 4210 y q 
5251, Models 1, 2 


Figure 2-3 (Part 5 of 11). EBCDIC Character Set 
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( The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


France 


First Hexadecimal Character 


Second 


Hexadecimal 0 1 3 4 7 A C E F 
Character 


ref folo 
fel] sf elolo 
ref-fe[sfol 


Dependent on the display station/printer you are using, see the following table: 


Note: 


Display Printer 


Station eb 


5224, 5225, 5262, 
4214, 4224, and 4210 


5251, Models 1, 2 


11, 12, and 5252 5256 


Figure 2-3 (Part 6 of 11). EBCDIC Character Set 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the ) 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


aly 


First Hexadecimal Character 


Second 

Hexadecimal 

Character 
Note: 


Dependent on the display station/printer you are using, see the following table: 


Character 


Display Printer 


Station 


8D | AD 


5292, 3179, 3180, 5224, 5225, 5262, F 
4214, 4224, and 4210 


/ 
and 3196 yo4 
5251, Models 1, 2 
11, 12, and 5252 2290 ae 


Figure 2-3 (Part 7 of 11). EBCDIC Character Set 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 


set Graphic Error Action control character or, if unspecified, by a hyphen. 


Portugal 


First Hexadecimal Character —___SESEEEsSsSsSsSF., 


Second 
Hexadecimal 
Character 


Notes: 


1. Dependent on the display station/printer you are using, see the following table: 


2. For 3180 or 3196 a”<”. For all others, a ”C”. 


Printer 
5224, 5225, 5262, ; / 
4214, 4224, and 4210 y A 
5256 < t = 


Figure 2-3 (Part 8 of 11). EBCDIC Character Set 


Display 
Station 


5292, 3179, 3180, 
and 3196 


5251, Models 1, 2 
11, 12, and 5252 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


Spanish Speaking/Spain 


First Hexadecimal Character 


Second 
Hexadecimal 
Character 
un 
F 
Note: 


Dependent on the display station/printer you are using, see the following table: 


Character 
Display Printer 
| Serer | Per ao] aD] ac | om 
5292, 3179, 3180, 5224, 5225, 5262, j 4 
and 3196 4214, 4224, and 4210 y I 
5251, Models 1, 2 


Figure 2-3 (Part 9 of 11). EBCDIC Character Set 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 
set Graphic Error Action control character or, if unspecified, by a hyphen. 


Second 
Hexadecimal 
Character 


Note: 


© 
ak 


je lelele 
> | ~ 
Tm | m 
o 
x 
7 
K 


aes 


- 
EL 


United Kingdom 


First Hexadecimal Character ——____L__L"""/"_LL"™"|"_E>=EN 


3) 


o) 
iq] 


, : 
, O: 
» | D: 
ry | m: 
on ‘?) 
3 
ey 


+ -_ 
~ ~~ 


Bee = 
_- Ww 


= 


A 
* 


7 


ao 


P| >| >| p> 


aio 


Ls] 


> —, 


8 


14>) 


aeaal 


zs | © 


Q 12) 
< x 
x 


<e) 


|} =] > 
—|oa | o 


co 
U 
om 


a) 
< 
m 


° 
Es 
= 


3 


za 


» 


fe) 
Note 


EF 


“~~ 
Lo 


, 


som 


oh 
A, ad Shee |! 41 
sfx sla 
€ | ik. |) F438 
Di M;| UU. 4 
E!N > V 

Fi/o; WwW) 6 


eo) 


Dependent on the display station/printer you are using, see the following table: 


Display 
Station 


5292, 3179, 3180, 
and 3196 


5251, Models 1, 2 
11, 12, and 5252 


Figure 2-3 (Part 10 of 11). 


Printer 


5224, 5225, 5262, 


4214, 4224, and 4210 


8D 


EBCDIC Character Set 


> 
Zz 
Oo 
mt 
oO 


Cc 


wy) ‘ : 
q Zz 
a O 
Com 
@ 
. oy OC: 
SY 4 Cc: 


N 
(vs) 


oO: | O 
CG 


or 
= Ee 
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The characters with a heavy line surrounding them are unprintable and will be represented as specified by the 


set Graphic Error Action control character or, if unspecified, by a hyphen. 


U.S., Canada, Netherlands 


First Hexadecimal Character 


Second 
Hexadecimal | 2 4 7 A C D E F 
Character 
_ieiel-fefel feist piste 
: 

P| lef e | felt |e a) ole 

ptt faye steel ite yfol 
Notes: 


1. Dependent on the display station/printer you are using, see the following table: 
2. Netherlands is supported only for the 5294 with the Enhanced Keyboard Feature installed. 


Displa Printer 
5292, 3179, 3180, | 5224, 5225, 5262, Peril) wes 
and 3196 4214, 4224 and 4210 Y | 
5251, Models 1, 2 
11, 12, and 5252 5256 te 


Figure 2-3 (Part 11 of 11). EBCDiC Character Set 
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EIA/CCITT Adapter 


This special feature allows the user to attach a con- 
troller to an external modem. The modem that it 
attaches to, however, must have (1) an interface that 
meets the E/A Standard RS232C and 100 Series Inter- 
change Circuits requirements defined in the CC/TT 
Internal Recommendations, Volume 24, and (2) elec- 
trical characteristics that are compatible with the 
electrical requirements of the E/A Standard RS232C 
and conform to the CCITT recommendations in 
Volume 28. This feature is restricted to a maximum 
speed of 9600 bps. 


Error Log 


The error log is a buffer that is 16 bytes long for the 
5251 Models 2 and 12 and an additional 64 bytes long 
for each installed cluster feature. On the 5294, the 
error log buffer is 128 bytes with 121-byte data area 
plus pointers that indicate which entries are valid and 
which have been sent to the host system. The log 
contains information about errors that have occurred 
(both software errors and errors sent from a signal). 
Hardware errors may be logged but not sent via a 
signal, because the unit was not in session. See the 
index entries errors, codes and negative responses. 


The format of the error log entries is: 
L,LSID,xxyy,S0,S1,S2,S3,S4 
L is the number of bytes in the entry. 


LSID is the local session identification address 
(See the index entries addresses and LSID.) 


xxyy is either the error code or the user bytes of 
the negative response that describe the condition 
Causing the error. xx is the device type and yy is 
the error type. 


$0, $1, $2, S3, and S4, if present, are predefined 
and used only as diagnostic maintenance infor- 
mation. 


The error log exists only in the controller. The 
remainder of the 5250 work stations are dependent 
on the controller or on a host system for error 
logging. 


Note: If the host system does not have a buffer area 
for the error log, its contents are lost when trans- 
mitted and valuable information necessary to diag- 
nose error-related problems is lost. 


Protocols and Synchronization for 5250 !mplementa- 
tion of SNA in Section 1 and index entries reqms 
command and recfms command describe how to 
access this error log. 


Field Control Word (FCW) 


Field control words (each 2 bytes) are sent by the 
user’s program to the controller via the Write to 
Display command. Field control words are optional 
and if coded, they should follow the field format word 
of the SF order. See the index entry SF order. Any 
field control word encountered during the modifica- 
tion of an existing format table entry is ignored. A 
field control word of hex FFXX will not be accepted by 
the LU. 


The types of field control words are (1) Magnetic 
Stripe Reader, (2) resequencing, (3) Selector Light 
Pen, and (4) Self-Check. The Magnetic Stripe Reader 
control words allow the reading of numeric encoded 
information from a magnetic stripe. The rese- 
quencing control words alter the sequence of sending 
information; they do not alter the sequence of infor- 
mation on the display. The Selector Light Pen control 
words permit attachment of a light pen. The Self- 
Check control words determine the validity of the 
data that is sent. 
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Magnetic Stripe Reader Feature 


The Magnetic Stripe Reader (MSR) feature provides 
the capability of reading numeric encoded informa- 
tion from a magnetic stripe. The Magnetic Stripe 
Reader card may be encoded with up to 128 numeric 
characters, including control characters. The fol- 
lowing requirements must be met when specifying a 
field for MSR input: 


e A field contro! word must be defined for the field 
only if operator ID (OID) secure data is to be 
entered into this field. 


— Hex 8101 is for an MSR OID secured field. 
When the MSR OID data is read into the field, 
the OID code is converted to a colon which 
appears in position 1 of the field to indicate 
secured data. 

— Hex 8103 allows both the Magnetic Stripe 
Reader and the Selector Light Pen to enter 
data. 


¢ The MSR data must be entered with the keyboard 
unlocked or after the System Request key is 
pressed, otherwise the data is lost and no error 


will appear to inform the operator of the situation. 


If the OID is encoded on the card, it can only be 
entered in response to the OID display provided 
by the host system. 


e MSR data can be entered into an I/O field. 


¢ Data will be entered starting at the cursor posi- 
tion; the operator must position the cursor within 
a field. 


e Data entered from the card must satisfy the 
requirements of any mandatory fill, check digit, 
signed numeric, numeric-only, alpha-only, and 
auto-enter specifications for the field into which 
MSR data is entered or the appropriate operator 
error will be posted. 


e There can be only one field on each magnetic 
stripe card. This field can range from 1 to 125 
characters in length for the 5251 and 5252 dis- 
plays. 


e No data overflow is allowed. Magnetic stripe 
data must all fit within the field or an operator 
error 0034 will be displayed. 


e The field starting attribute (nondisplay) must be 
supplied using the SF order. 


Resequencing 


Resequencing allows the controller to send the input 
fields to the host system in any specified order. 
Resequencing is accomplished by chaining input 
fields together via field control words (FCW) speci- 
fying resequencing. The format of the resequencing 
FCW is as follows: 


Binary Description 


8-15 The normal sequence position of the 
next field to be returned to the host 
system. (The first field on the screen is 
number 1; the field numbers progress 
sequentially, left to right and top to 
bottom.) 


The first field to be sent to the host system is identi- 
fied in the start of header (SOH) by its number. If the 
first field identifier in the SOH is set to zero, rese- 
quencing will not occur (that is, all resequencing 
FCWs will be ignored; fields will be sent to the host 
system in the order defined in the format table). The 


last field to be sent to the host system must have a 
field control word defined as follows: 


Binary Description 
11111111 


Notes: 

1. Aclosed resequencing loop will result in an 
endless transmission of data, terminated only by 
a negative response, Unbind, or Dactlu from the 
host system. See the index entries SNA, com- 
mands and negative responses. 

2. It is not a requirement to have a resequencing 
FCW for each field. An FCW pointing to the next 
sequential field will be assumed if no rese- 
quencing FCW is specified. (The last field in the 
format table must have a resequencing FCW.) 
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See the index entry SOH order for more informa- 
tion. 


Selector Light Pen Feature 


The Selector Light Pen feature is a pen-like device 
that permits the operator to select fields of data from 
the display screen for system input. The ease with 
which the operator can select and designate the 
correct light pen field is affected by the format, 
content, intensity, and spacing of the light pen fields 
upon the screen. The following requirements must 
be met when specifying a field for the selector light 
pen: 


e A field control word must be defined for the field: 
— Hex 8102 is for a selector light pen tip switch 
allowed field. 
— Hex 8103 allows both magnetic stripe/slot 
reader and selector light pen to enter data. 


e Light pen fields on the same line should be sepa- 
rated by at least four characters. 


e The light pen field should be formatted as 
follows: 


@?b*bxx...x@ 


@- The leading attribute should be high 
intensity. The trailing attribute should be 
normal intensity. 


?- A designator character (7?) in the first 
position of the field indicates filed 
selection or reselection. This character 
should change from ? to > after 
selection and back to ? after reselection. 


b - A blank should separate the designator 
character from the rest of the field. 


- A target character (asterisk) may be 
inserted into the field format. This char- 
acter enhances the pen’s ability to detect 
the field and the pen should be aimed at 
this target character during the selection 
process. 


xXx...x - These character combinations indicate a 
variable length name or description of 
the selectable field. (The name should 
be at least 2 characters long.) 


Self-Check Feature 


The Self-Check feature on the controllers provides 
additional integrity for the data entry. All field types 
can be specified for self-checking. The following 
requirements must be met when specifying a field for 
self checking: 


° A field control word must be defined for the field: 
— Hex B1A0 is for Moduius 10 checking. 

— Hex B140 is for Modulus 11 checking. 

e Field lengths for checking are restricted to 33 
positions. For signed numeric fields, only 32 
positions can contain digits. The sign is not 
checked. If more than 33 characters are given, a 
Lustat parameter error results. 

e The Self-Check feature must be installed or a 
Lustat parameter error results when self check is 
specified for the field and the operator tries to 
leave the field. 


The Self-Check feature resolves fields and conditions 
in the following ways: 


e The feature converts nonnumeric characters, 
including nulls and blanks, by using the 4 low- 
order bits from their EBCDIC representation, 
when the low-order bits are in the range 0-9. For 
example: 

— Ain EBCDIC is C1; therefore A 
— Rin EBCDIC is D9; therefore R 


1. 
9. 


All other characters with the 4 low-order bits in 
the range of hex A through F are replaced by 0. 
For example: % is EBCDIC 6C; therefore % = 0. 


Null and blank characters are also converted to 
0. All high-order nulls, zeros, and blanks ina 
field are converted to 0 and do not affect the 
value of the check number. 

e An all-null field checks correctly. This kind of 
field can result when an operator has unsuccess- 
fully tried to enter digits into a field and checking 
fails, so the controller allows the operator to exit 
the field from the first position by using the Field 
Exit key. 
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e A duplication character (hex 1C) resulting from 
the operator using the Dup key automatically 
causes the field to pass this test. 

e Checking errors result in the controller issuing a 
0015 error code and placing the cursor at the first 
position of the field containing the error. 


Field Format Word (FFW) 


Field format words (each 2 bytes long) are sent by 
the host system in the SF order to the controller to be 
placed in the format table. They allow the pro- 
grammer to control the type of fields on the display. 
The index entry fields references the details for the 
types of fields that are supported and their character- 
istics. See the index entries SF order and format 
table for additional information. The following 
describes the meanings of the field format word bits: 


Be [en [tose [pescipton 
1 0-1 {01 


Bypass. 
This is not a bypass field. 
This is a bypass field. 

Dup enable. 

Duplication is not allowed 

in this field. 

Duplication is allowed in 
this field. 

Modified data tag (MDT). 
This field has not been 
modified. 

This field has been 
modified. 

Note: This bit may be turned 
on by the host system 

before being sent to the 
display. 

Field shift/edit 
specifications. 

Alphabetic shift. 

Alphabetic only. 

Numeric shift. 

Numeric only. 

Katakana shift. 

Digits only (5294). 

I/O (magnetic stripe 

reader, selector light 

pen input only). 
Signed numeric. 


Brie [en [ode [beecipton 
2 0 


Auto enter. 

No auto enter. 

Auto enter. 

Field exit required (FER). 
Field exit key is 

not required. 

Field exit key is required. 
Monocase. 

Accept lowercase letters. 
Translate operator-entered 
letters to uppercase. 
Reserved. 

Mandatory enter. 

This is not a mandatory 
enter field. 

This is a mandatory enter 
field. 

Right adjust/mandatory 
fill (MF). 

No adjust specified. 
Reserved. 

Reserved. 

Reserved. 

Reserved. 

Right adjust, zero fill. 
Right adjust, blank fill. 
Mandatory fill. 


No checks are made against the field format word 
when the host system writes to the display; therefore, 
the user can initialize the field the user wants. The 
host system can turn on the master MDT bit by 
placing in the display data stream a field format word 
with bit 4 on. When there is a Read MDT command, 
the field is sent back to the host system as if the 
operator had modified it. 
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The following table identifies the types of fields avail- 
able and their characteristics. The display fields are 
defined by the field format word. The information in 
parentheses immediately following the field name 
gives the byte and bit identifiers of the field in the 
field format word. See the index entry field format 
word for specific bit information. 


Field Type 


Alphabetic only (byte 
1, bits 5-7 = 001) 


Description 


Accepts only characters A-Z (both uppercase and lowercase plus the , . - and blank 
symbols). Other characters cause operator errors. Some special characters for 
World Trade countries are also acceptable. 


Alphabetic shift (byte Accepts all characters. The shift keys are acknowledged. The characters on the 
1, bits 5-7 = 000) lower symbol of each key are valid. 


Auto enter (byte 2, Sends the contents of all fields except Read MDT fields to the host system when the 
bit 0) operator either enters the last character into the last position of the field or enters 


one of the field exit keys. (The only Read MDT fields sent are those that have been 
modified.) 


Bypass (byte 1, bit 2) Entries are not allowed in this field. If the operator tries to enter something into this 
field, an error results. 


Dup enable (byte 1, The controller repeats hex 1C from the cursor position to the end of the field when 
bit 3) the operator presses the Dup key; this shows on the display as an overstruck 
asterisk. 


Field exit required Requires the operator to exit the field with a nondata key. When the operator has 
(byte 2, bit 1) entered the last character, the cursor remains under the character and blinks, indi- 
cating that a Field Exit key is required. 


I/O (byte 1, bits 5-7 Rejects any data keys from the keyboard. The operator can move the cursor in and 

= 110) out of the field as in a nonbypass field. Any entered data results in an error. Data 
from a magnetic stripe reader or selector light pen can be entered into an I/O field 
without causing an error. 


Katakana shift (byte This is the same as the alphabetic shift except the keyboard is Katakana and is 
1, bits 5-7 = 100) placed in Katakana shift. 


Mandatory enter Requires the operator to enter something in the file before the controller allows the 
(MD) (byte 2, bit 4) Enter key to be active. The controller recognizes the state of these fields by 


checking the MDT bit for the field. If the operator tries to bypass the field using a 
Field +, Field -, or Field Exit key, an error occurs. 


Digits only (byte 1, Allows digits 0-9 only from keyboard. Also allows the DUP key if the DUP enabled 
bits 5-7 = 101) bit in the FFW is on (5294 only). 
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Mandatory fill (MF) Requires that once the operator has entered data into the field, he must completely 
(byte 2, bits 5-7 = fill the field before exiting. Any attempt to leave an unfilled field causes an error. 
111) The operator can use the Dup key to fill the field. If the field is nulled when the oper- 
ator exits from the first position using the Field Exit or Erase Input key and the MDT 
bit is on, the null fields can be set back to the host system in response to a red 
command. 


Monocase (byte 2, bit 
2) 


Regardless of the shift state, the keyboard enters only the uppercase characters 
A-Z in the field. In addition, the following characters on the specified World Trade 
typewriter keyboard wil! be translated to uppercase. 


For the remaining World Trade typewriter-like and all data entry keyboards, the low- 
ercase special characters are keyed and displayed as is. 


Numeric only (byte 1, Accepts only characters 0-9 and the symbols + , . - and blank. Any other character 

bits 5-7 = 011) Causes an operator error. The unit position carries the sign digit for the field. Use 
either the Field +, the Field -, or the Field Exit key to exit this field. If you use the 
Field - key to exit the field, the controller changes the zone of the low= order digit to 
hex D, unless it is one of the symbols (+ -, . or blank); in this case, an error results. 


Numeric shift (byte 1, Accepts all characters. 
bits 5-7 = 010) 


Right adjust (byte 2, Fills all left-most unoccupied positions of a field with the specified character; char- 
bits 5-7; 101 = acters are right-adjust and spaces are blank-filled or zero-filled. The user must 
110-blank) specify this as either blank or 0. The fill character will appear on the display. 


Signed numeric (byte 
1, bits 5-7 = 111) 


Allows only characters 0-9. An attempt to enter any other character causes an error. 
The field must be at least 2 bytes long. Reserves the rightmost position for the sign 
display (- for negative and null for positive). The operator cannot key a digit into the 
last position; an error results if this attempt is made. Use either the Field +, the 
Field -, or the Field Exit key to exit this field. If you use the Field - key to exit this 
field, the controller right adjusts the field and places a negative sign in the right- 
most position. If you use Field +, the controller right adjusts the field and blanks 
the rightmost position. The rightmost sign position is not sent to the host system in 
response to either the Read MDT or Read Input commands. The rightmost character 
is affected in the following way before it is sent to the host system: If it is a negative 
sign, the zone of the low-order digit is set to hex D. If it is positive, the low-order 
digit is not changed. 
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Format Level 0 


Format level 0 is the condition of the format table at 
power-on and reset time. It has the following charac- 
teristics: 


1. There is one input field that goes from row 1, 
column 2 to the last row, column 80. 


2. The field is normal entry; no Field Exit key is 
required; there are no mandatory enter, no auto- 
record advance, no right adjust, and no manda- 
tory fill field requirements. 


3. The error line is on row 1. 

4. Alphabetic shift is in effect. 

5. No field control words are specified. 

6. Uppercase and lowercase output is allowed. 


See also the index entry power-on state. 


Format Table 


A format table contains the format information for the 
displays. There is one format table for each display. 
The Write to Display command from the host system 
builds the format tables. The entries in the tables 
define the characteristics of the field. Specifically, 
the format tables contain entries that describe (1) 
each input field that is returned to the system by all 
read commands (except Read Screen) and (2) each 
field that is modified from the keyboard (see the 
index entry MDT bit). 


The format table contains the field control and field 
format words. It has room for a maximum of 127 
fields if there are no field control words and no SOH 
order (see the index entry SOH order). The field 
length, field format, and field control words are sent 
by the host to the controller in the Write and Display 
command in the display data stream. The controller 
then stores these in the current format table. At 
power-on time, the format table is at format level 0. 
See these index entries for details: fie/d control 
word, field format word, format level 0, and display, 
commands. 


Frame - SDLC 


The frame is the SDLC format used to convey com- 
mands and information between the host system and 
the controller. The SDLC frame is the organizational 
unit required to send information between the host 
system and the controller using remote attachment. 
The frame is what the host system and controller use 
to send requests for service, commands, data, and 
responses to each other. To be valid, the frame must 
be bounded by flags, and must be a minimum of 32 
consecutive bits in length, or any greater length divis- 
ible by 8. The frame has a fixed format. This format 
is as shown: 


FA C | FCS F 


Bytes: 1 1 1 Determined by physical 2 1 
limitations required 


for accuracy. 


The | field is an optional field. 

It is where the SNA RUs reside. 

The | field is associated with 

an information frame and is 
restricted to a maximum of 261 

bytes for the 5251 Model 2 or 12. 

See the index entry SDLC, commands 
and responses 


The first F is a flag; A is the address of the referenced 
controller; C contains commands, responses, and 
information about the frame type (and commands and 
responses for the data link and link level types of 
formats); FCS performs transmission checking; and 
the last F is another flag. The following text explains 
each of the fields in more detail. 


Flag Sequence (F) 


All frames start and end with the bit sequence 
01111110. An ending flag for one frame can also be 
the beginning flag for the next, or a single ending 0 
can be shared to couple the ending flag sequence of 
one frame with the beginning flag sequence of 
another. The communications adapter hardware 
checks for the flag sequence. 
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Station Address Field (A) 


This is the first 8-bit sequence following the flag; it 
contains the controller station address which identi- 
fies the secondary station (controller) that is involved 
in the transmission. See the index entry station 
address for details: 


Control Field (C) 


The control field is one byte long; it contains (1) com- 
mands and responses, (2) the poll bit for the host 
system, (3) the final bit for the controller, and (4) the 
sequence numbers for some commands and 
responses. See the index entries SDLC, commands 
and responses and P/F bit for detailed information. 


The control field supports three frame types; they 
are: information, nonsequenced, and supervisory. 
Of those three frame types, only the information (I) 
frame contains data for the LUs. The other frames 
are for SDLC link-level control. The control field for 
each frame type is different. Do not confuse the | 
control field with the information field. It is the infor- 
mation field of the information frame that contains the 
RUs that the | frames support. The information 
format of the control field only identifies the informa- 
tion frame. The | format has this configuration: 


Information (1) Format: 


012|3 |456|7 
|Nr |PF|Ns 0 


The | frames are used to transfer information. They 
are the only frames that contain Ns bits. 


Nr = Station-receive sequence count; 3 bits for error 
detection and recovery. 


Ns = Station-send sequence count; 3 bits to number 
information frames as they are sent. 


P/F = Poll/final bit. The poll bit is in frames sent by 
the host system, and the final bit is in the 
frames sent by the controller. 


The controller cannot send a response to the host 
system until it receives a frame with the poll bit on. 
When the controller responds to a command from the 
host, it will send no more than seven consecutive 
Il-frames. The transmission of the I-frames will be fol- 
lowed by either a ready to receive (RR) or a receive 
not ready (RNR) response and the F bit of this last 
frame will be on. This indicates to the host system 
that the controller has finished. 


In this example, the frames are traveling 


ae 
with F ! 


bit on 


Information Field (I) 


This field contains such things as the RUs (LU data 
streams), status, controls, and SNA responses and 
commands. The | field of an information frame con- 
sists of 2 bytes of TH followed by 3 bytes of RH and 
finally followed by up to 256 bytes of RU. The 
maximum length of this field is 261 bytes (including 
the SNA header information, which is 5 bytes long, 
and the RU, which can be a maximum of 256 bytes 
long). See the index entries RU; RH; TH; and SNA, 
commands for specific information about the contents 
of the I-field. 


| TH RH - RU | 


Flag Uniqueness 


The frame can consist of any sequence of bits. If 
there are five consecutive 1s, the controller inserts a 
0 when transmitting and deletes a 0 when receiving 
to indicate that the bit sequence has been checked. 
This prevents data from being misinterpreted as a 
flag. 


Frame Check Sequence (FCS) 
This field is 16 bits long. It is used for detecting 


transmission errors. Any frame that contains an FCS 
error is discarded. 
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Graphics Introduction 


Graphics on the 5250 Information Display System is 
implemented by using the 5292 Color Display Station 
Model 2. The 5292 Model 2 also has three standard 
interfaces for I/O features. The three interfaces are: 


e lIEEE-488 digital interface for plotters 


e Video interface for video film camera or video 
monitor 


e Parallel printer interface. 


The 5292 Color Display Station Model 2 can display 
alphanumeric (A/N) and graphic images, such as pie 
charts and line drawings using flexible line styles and 
line widths. The displays can be in seven (plus black, 
which cannot be changed) colors selected from a 
palette of 512. The graphic images are displayed by 
selecting the color and a combination of addressable 
dots (PELs or picture elements) on the display 
screen. The PELs are addressed by X and Y coordi- 
nates as shown below. 


XO X479 


¥287 —— 


5292 Graphics orders in the data stream allow the 
programmer to draw a line between X and Y coordi- 
nates (vector graphics), fill areas with color, and vary 
line style and width. 


5292 Select Options 


The 5292 Color Display Station Model 2 has options 
available from the keyboard during online select 
option mode to control graphics. These options are 
activated by pressing certain key sequences. The 
select options available are: 


e Erase graphics display: Seiecting this option 
erases the graphics buffer, which clears the 
graphic display. 


« Terminate graphics processing: Selecting this 
option discontinues graphics mode and termi- 
nates graphics processing. 


e Graphics display-on/off: Selecting this option 
turns the graphics display on and Off. 


e Screen copy: Selecting this option copies from 1 
to 20 copies of the screen to an output printer 
device. 


More information on select options is contained in 
the 5292 Color Display Station Models 1 and 2 Opera- 
tor’s Guide, GA21-9416. 


Graphic Display Indicators 


There are two additional indicators on the 5292 
display that pertain to graphic displays. 


e Graphic Display-On indicator: When graphics 
display is on, a blue G appears on the indicator 
line of the display. 


e Graphics Mode indicator: This is the same indi- 
cator as the input-inhibited indicator on the 
Model 1 except that the indicator is blue for 
graphics mode or screen copy. When the 
Graphics Mode indicator is on, the keyboard on 
the 5292 Model 2 is locked. 


e Screen copy count: This is a blue number on the 
lower right that indicates the number of copies to 
be produced. 


More information on 5292 Model 2 Display indicators 


is contained in the 5292 Color Display Station Models 
1 and 2 Operator’s Guide, GA21-9416. 
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Graphic and I/O Feature Orders 


Graphic bytes consist of Graphic orders, I/O Feature 
orders, and data associated with the orders. The 
graphic bytes in a graphics data stream must begin 
with hex FF (Begin Graphics order) and end with hex 
95 (End Graphics order) as shown below. 


Graphic Bytes 


Graphic Orders, 


|/O Feature Orders, Data 


Graphic bytes are sent to the 5292 Model 2 in write 
blocks. A graphic write block has a maximum length 
of 256 bytes and a minimum length of 11 bytes. 
Graphic blocks may be sent to the 5292 Model 2 by 
single blocks, where each graphic write block begins 
and ends graphic mode as shown below. 


Single Write Block 


Graphic 
F 


9,5 
— 256 Bytes Maximum —+| 


If a group of blocks is sent, graphic data for certain 
orders may span blocks. For orders where data can 
span blocks, the data can be split by using the More- 
Data-to-Come order (hex 91) as shown below. A 
detailed description of each Graphic order and 
whether data can span blocks for that order is con- 
tained in Section 2 of this manual. 


Multiple Write Spanned Blocks 


Graphic Graphic 


F Bytes 


| —— 256 Bytes Maximum ——+}ea— Last Block —| 


A group of graphic write blocks can also be sent by 
using the End Graphics Block order (hex 90) to 
specify the end of a graphics write block without 
ending graphics mode as shown below. 


Multiple Write Nonspanned Blocks 


Graphic Graphic 


— 256 Bytes Maximum —+>|<— Last Block —| 


Pacing 


Pacing is the method used by the host system to send 
graphics data streams to the display station inde- 
pendent of the display station busy status. Pacing is 
necessary because some graphic operations, espe- 
cially to the I/O interfaces, take several seconds to 
complete. This would exceed the work station con- 
troller time-out unless a way is provided to release 
the work station controller before graphic data is fully 
processed. Pacing is accomplished on the 5292 
Model 2 by resetting busy as soon as a graphics 
block is received. When the graphics block is fully 
processed, a graphics aid key is returned to the host 
to indicate the display station is ready to process 
another graphics block. More details on pacing are 
contained later in this section. 
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Graphic and I/O Feature 
Orders 


The data stream that defines the graphic displays and 
|/O feature operations is sent from the host using 
normal 5250 Write commands. The graphic and I/O 
feature data streams are made up of a combination of 
orders and data as shown below. 


Orders and 


F 9/5 


— Graphic Write Block —| 


The 8 bits that make up a graphic byte have the fol- 
lowing format: 


}~——— Graphic Byte ———>| 


olijais|a}sjela 


a 


Bits 0 and 1 Bits 2 and 3 Bits 4 through 7 


01 Graphic Data Bits 2 through 7 contain data to be used with a previous order. 


10 Graphic Order OO Read Order Bits 4 through 7 identify a specific 
01 Control Order order. 
10 Draw Order 
11 Set Order 


00 |/O Printer Control Order 
01 1/O IEEE Set Order 

10 |/O IEEE Local Command Order 
11 Reserved 


Bit 
Position 


11 1/O Feature Order 
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There are two control orders that have a special 
meaning and must begin with the first byte ina 
graphics write block as shown below. 


Hex FF Begin Graphics Order a order turns on graphics mode 
and identifies the following bytes as graphic bytes. 
Hex FF Hex FF System Graphics Reset [This order terminates graphics processing, ends 
graphic mode, and returns a graphic AID key 
code to the host (See Pacing in this chapter.). 


The Graphic and I/O Feature orders are described in 
detail in the following sequence: 


1. Graphic Control orders 

2. Graphic Set orders 

3. Graphic Draw orders 

4. Graphic Read orders 

5. |/O Feature: Printer orders 


6. 1/O Feature: IEEE Interface orders. 
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Graphic Control Orders 


Graphic Control orders control the processing of 
graphic data streams. Control orders have no data 
associated with the order. The following chart sum- 
marizes the control orders, and a detailed description 
of each order follows the chart. 


Data Bytes 
Graphic |Used with  /|End of Data 
This Order |Required 


End Graphics Block 

More Data to Come 

End of Data 

Graphics Display On 

Graphics Display Off 

End Graphics 

Suppress Pacing Response |96 


End Graphics Block Order 


Function: The End Graphics Block order tells the 
5292 Model 2 to ignore the remaining bytes in the 
current graphics write block, and to prepare to 
receive the next graphics write block. 


Format: 


Byte 1 
Graphic Order 


Description of Data 


No data for these orders. 
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More-Data-to-Come Order 


Function: The More-Data-to-Come order tells the 
5292 Model 2 that the next write block will contain 
more data for the current order. This order is valid 
for variable length data orders only. 


Format: 


Byte 1 
Graphic Order 


Example: The following graphic data stream shows 
a Graphic order where the data associated with the 
order spans write blocks. The More-Data-to-Come 
(MDTC) order tells the system that the next write 
block contains more data. 


The MDTC order tells the system that this is the end 
of this write block and the next write block contains 
more data. 


Graphic 
F | F | Order, Data 


— 250 Bytes —_—__+|-<— Next Write —»| 


Block 


More Data 


End-of-Data Order 


Function: The End-of-Data order tells the 5292 Model 
2 that this is the end of the data associated with the 
previous order. This order is valid only for variable 
length data orders and must be preceded with at 
least 1 data byte. This order ends the previous order. 


Format: 


Byte 1 
Graphic Order 


Graphics Display-On Order 


Function: The Graphics Display-On order turns on 
the 5292 Model 2 graphic display. This allows the 
display station to display data from the graphics 
buffer. Graphics display on is indicated at the 5292 
Mode? 2 by a blue G on the left side of the status line. 


When the graphics display is turned on at the 5292 
Model 2, reduced line spacing will be in effect. 


Format: 


Byte 1 
Graphic Order 
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Graphics Display-Off Order 


Function: The Graphics Display-Off order turns off 
the graphics display at the 5292 Model 2. Graphics 
Display-Off is indicated at the 5292 Model 2 by the 
blue G on the status line going off. 


When the graphics display is turned off at the 5292 
Model 2, the reduce line space reverts to the status 
that was in effect when graphics display was turned 
on. 


Format: 


Byte 1 
Graphic Order 


End Graphics Order 


Function: The End Graphics order ends graphics 
mode. The 5292 Model 2 cannot accept Graphic 
orders, |/O Feature orders, or graphic data until 
graphics mode is started again by a graphics data 
stream with the first byte of hex FF. The blue Input 
inhibited indicator on the status line of the 5292 is 
turned off. 


Format: 


Byte 1 
Graphic Order 


Suppress Pacing Response Order 


Function: The Suppress Pacing Response order 
specifies that no graphics aid key code will be 
returned to the system following completion of 
current graphic block processing. 


CAUTION 

When this order is used, the normal pacing function 
is altered and the programmer must provide proper 
pacing control. 


Format: 


Byte 1 
Graphic Order 
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Graphic Set Orders Graphic Set orders, and a detailed description of J 
each Set order follows. 

The Graphic Set orders are used to set up graphics 

display attributes such as color, line style, and line 

width to be used by subsequent Draw orders. The 

values specified in the Set orders remain in effect for 

subsequent Draw orders until another Set order 

changes the value. The following list summarizes the 


Data Bytes 
Graphic Used with /End of Data 
This Order |Required Description of Data 


Set Color Table Table index/value 
Set Color Color index 
Set Style Line style 


Set Style Offset Line style offset 

Set Function Function type 

Set Marker Marker type 

Set Line Weight Line weight 

Set Fill Mode Fill control information 


Set Color Table Order 


Function: The Set Color Table order allows the pro- 
grammer to choose seven display colors (plus black, 
which cannot be changed) from a palette of 512. The 
color table contains 3 intensity bits for each of the 
primary colors (red, green, and blue). The intensity 
bits for each of the primary colors can be set by using 
the Set Color Table order to achieve the desired tint 
or shade for each of the seven color indexes. A 
value of 7 indicates maximum intensity for a primary 
color. The color table is initialized to the following 
values. Multiple color indexes can be changed per 
order. 


Black (This color index 
cannot be changed.) 


Red 
Green 
Blue 


Pink 


Yellow 
Turquoise 


White 
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Format: 


Byte 1 
Graphic Order 


i 


Byte 1 


Byte 2 


Byte 3 


Byte 4 = 


Byte 2 Byte 3 Byte 4 
Graphic Data Graphic Data Graphic Data 


This is the Graphic order for the set 
color table. 


The binary value of the nnn bits is the 
color index you want to set. 


The rrr bits control the red intensity. 
The ggg bits control the green inten- 


The bbb bits control the blue intensity. 


More color changes can follow until an end of data is 


encountered. 


Example: The following Graphic order will reduce 
the color index 1 red intensity two increments from its 
default value of seven. 


Byte 1 
Graphic Order 


Byte 2 Byte 3 Byte 4 
Graphic Data Graphic Data Graphic Data 


4 


No change to green density. 


Red changes two units. 
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o change to blue density. 


Set Color Order 


Function: The Set Color order specifies the color to 
be used on subsequent Draw orders. 


Default: The default color index is 7. 


Format: 


Byte 1 Byte 2 
Graphic Order Graphic Data 


The binary value of bits aaa specifies the color index 
(0 through 7) to be used for subsequent Draw orders. 


Example: The following Graphic order and data byte 
will set the display color to color index 1 for subse- 
quent Draw orders: 


Byte 1 Byte 2 
Graphic Order Graphic Data 
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Set Style Order 


Function: The Set Style order specifies the line style 
to be used for subsequent Draw orders. You can 
specify a solid line or a dotted line with variable 
visible lengths and variable unchanged PELs 
between the visible PELs. 


Default: The default value is hex FOFO, which is a 
solid line. 


Format: 


Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 
Graphic Order Graphic Data Graphic Data Graphic Data Graphic Data 


Byte 1 = This is the Graphic order for the set 
line style. 
Byte 2 = The binary value of the aaaa bits is 


the length (number of PELs) of the first 
visible segment of the line style. 


Byte 3 


The binary value of the bbbb bits is 
the number of unchanged PELs that 
follow the first visible segment. 


Byte 4 = _ The binary value of the cccc bits is the 
length of the second visible segment 
of the line. 


Byte 5 The binary value of the dddd bits is 
the number of unchanged PELs that 


follow the second visible segment. 


Example: The following Graphic order and graphic 
data will set the line style shown below on a blank 
background. 


Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 
Graphic Order Graphic Data Graphic Data Graphic Data Graphic Data 


12 PELs 2 PELs 2 PELs 2 PELs 
Visible Invisible Visible Invisible 


an ee 
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Set Style Offset Order as 


Function: This order specifies which of the four 
length values you want to start with when using the 
line style specified in a previous Set Style order. You 
can select one of the four lengths specified in the pre- 
vious Set Style order and also specify an override 
length for the value selected. 


Default: The default value is hex 00, and causes the 
line to start as it was specified in the previous Set 


Style order. 


Format: 


Byte 1 Byte 2 
Graphic Order Graphic Data 


Byte 1= This is the Graphic order for the set 
style offset. 
J 
Byte 2 = The binary value of the aa bits repres- 


ents the first, second, third, or fourth 
segment length that was specified in 
the preceding Set Style order. This 
segment will be used for the first line 
segment on subsequent Draw orders. 


Example: The following Set Style order was issued 
previously for the following line style. 


Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 
Graphic Order Graphic Data Graphic Data Graphic Data Graphic Data 


12 PELs 2 PELs 2 PELs 2 PELs 
Visible Invisible Visible Invisible 


\ 
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The following Set Style Offset order and data speci- 
fies the first line segment to be drawn by subsequent 
Draw orders to be 1 PEL in lenath. 


Byte 1 Byte 2 
Graphic Order Graphic Data 


‘e 


pecifies the first line 
segment to be 1 PEL in length. 


Specifies the third segment in the 
preceding set style order is to be used 
first (1st=00, 2nd=01, 3rd=10, 4th=1 1). 


\ 


2 PELs after First 
Line Segment 


ui 


— 
bn 8 
m 
a 


Set Function Order 


Function: The Set Function order determines how 
subsequent Draw orders will be combined with the 
existing picture. This order allows you to specify 
whether you draw over an existing picture (replace), 
or combine the existing picture color with the color 
you are drawing to display a different color. 


Default: The default value hex 11 specifies replace, 
which will result in the color you are drawing 
replacing any existing color. 
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Format: 


Byte 1 Byte 2 
Graphic Order Graphic Data 


Byte 1 = This is the Graphic order for the set 
function. 
Byte 2 = The binary values of the aa bits have 


the following meaning: 


00 Reserved. 

01 = OR: If you specify this value, 
the color you are drawing will 
be combined with the existing 
color using OR logic. 


10 = XOR (exclusive OR): If you 
specify this value, the color 
you are drawing will be com- 
bined with the existing color 
using exclusive OR logic. 


11 = Replace: This is the default 
and specifies that the color 
you are drawing will replace 
the existing color. 


Example: lif you are drawing a red line and 
encounter an existing white PEL, the resulting color- 
assuming default colors will be: 


Byte 1 Byte 2 
OR 001 (Red) Order Graphic Order Graphic Data 
111 (White) Used 


111 Resulting Color (White) 


XOR 001 Order Graphic Order Graphic Data 
111 Used 


110 Resulting Color (Turquoise) 


Replace 001 Order Graphic Order Graphic Data 
111 Used 


001 Resulting Color (Red) 
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Set Marker Order 
Function: The Set Marker order establishes the type 
of marker that will be drawn for subsequent Write 


Polymarker orders. 


Default: The default value for this order is 0000 
which will be a solid 5 X 5 box. 


Format: 


Byte 1 Byte 2 
Graphic Order 


Graphic Data 


Byte 1 = This is the Graphic order for the set 
market order. 


Byte 2 = The aaaa bits define the type of marker to 
be drawn. The values for the aaaa bits 
result in the following markers: 


aaaa 

bits Description Marker 

0000 _ = Solid 5 x 5 box zal 
(default) 

0001 Solid 3 x 3 box nw 

0010 Empty5x5box 

0011 5x5 plus sign a 

0100 5x5 cross x 

0101 Solid5x5 ® 
diamond 

0110 Hollow5x5 © 
diamond 

0111 3 segment asterisk X 

1000 4 segment asterisk * 


Set Line Weight Order 


Function: The Set Line Weight order determines 
which line width will be used for subsequent Draw 
Polyline orders. The values that can be specified on 
this command are single line width (normal) or 
double line width. 


Default: The default value is 0, which results in 
single line width (normal). 


Format: 


Byte 1 Byte 2 
Graphic Order 


Graphic Data 


Byte 1 = This is the Graphic order for the set line 
weight. 


Byte 2 = The a bit determines if the line weight will 
be single weight or double weight as 
follows: 


a bit = 0 Single width 
a bit = 1 Double width 
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Set Fill Mode Order 


Function: The Set Fill Mode order establishes the fill 
and reference line information that will be used for 
subsequent Fill Polygon and Define Shield Area 
orders. 


Default: The default values are: 


aa bits 00 The interior style will follow a 
vertical reference line. 
bb bits 00 Draw a solid boundary line and 


fill with current style. 
cccccc 000000 The reference line will not be 
shifted. 


Format: 


Byte 1 Byte 2 Byte 3 
Graphic Order Graphic Data Graphic Data 


Byte 1 = This is the Graphic order for the set fill 
mode. 
Byte 2 = The aa bits determine the reference 


line to be used for a Fill Polygon order 
as follows: 


aa bits 00 The interior style will 
follow a vertical refer- 
ence line. 


aa bits 01 The interior style will 
follow the polygon edge. 


aa bits 10 The interior style will 
follow a +45 degree 
from vertical reference 
line. 


aa bits 11 The interior style will 
follow a - 45 degree from 
vertical reference line. 


Byte 3 = 
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The bb bits determine the fill mode to be 
used for subsequent Draw orders as 
follows: 


bb bits 00 This mode will draw a 
solid boundary line and fill 
the polygon with the style 
specified in the Set Style 
order. 


bb bits 10 This mode will drawa 
solid boundary line only. 


bb bits 10 This mode will fill the inte- 
rior of the polygon with the 
style specified in the Set 
Style order. 


bb bits 11 This mode will draw the 
boundary only with the 
style specified in the Set 
Style order. 


The cceccc bits specify the amount the 
reference line is to be shifted. The 
value of the cccccc bits is the number 
of PELs that the reference line is to be 
moved left. 


J 


Example: The following Graphic order and graphic 
data will result in setting the fill mode to cause a 
solid boundary line and polygon fill that will follow a 
+45 degree reference line that is offset 3 PELs to the 
left. The fill will occur when a Fill Polygon order is 
issued. The style for the fill lines will be defined by a 
previous Set Style order. 


Byte 1 Byte 2 Byte 3 
Graphic Order Graphic Data Graphic Data 


Graphic Order for 


Set Fill Mode 
Offset of Reference 
Line 3 PELs to Left 
Draw Solid Edge 
and Fill with Style 
+45 Degree 
Reference Line 
+45 Degree 
Reference Line |. |~«——— Reference Line Shifted Left 3 PELs 


Solid Boundary 


+45 Degree Fill Lines 
(The current style 
determines the width of 
lines and spaces.) 
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Graphic Draw Orders 


Graphic Draw orders are the group of orders that 
draw the images on the display screen. The line 
weight, line style, color, and fill modes are defined in 
previous Graphic Set orders. The following chart is a 
summary of the Graphic Draw orders. A detailed 
description of each order follows the chart. 


Data Bytes 
Graphic Used with  /|End of Data 
This Order Description of Data 


Write Background Background color 

Draw Polyline X and Y coordinates 
Draw Scanline X and Y PEL pattern 
Write Polymarker X and Y coordinates 
Fill Polygon X and Y coordinates 
Define Shield Area X and Y coordinates 


Write Background Order 


Function: The Write Background order writes the 
entire background on the screen to the color speci- 
fied in the data byte. The line style and function are 
determined by the current line style and function. 


Format: 


Byte 1 Byte 2 
Graphic Order Graphic Data 


Byte 1 =  Thisis the Graphic order for the write 
background. 
Byte 2 = The binary value of the aaa bits is the 


color index that the order will use 
when it writes the background. 
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Draw Polyline Order 


Function: The Draw Polyline order connects X and Y 
coordinates defined in the graphic data bytes that 
follow the Draw Polyline order. The current line 
style, color, width, and function are used. Each X and 
Y coordinate is defined in 4 graphic bytes that follow 
the order. This order will connect all coordinates 
specified in the graphic data bytes until an End-of- 
Data order is encountered. 


Format: 


Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 
Graphic Order Graphic Data Graphic Data Graphic Data Graphic Data 


512 | 256 | 128 64 32 16} 8 4 2 1 


10 Bit Binary Value 
Byte 1 = This is the Graphic order for the 


draw polyline. 


Bytes 2 and 3 The binary value of the a bits is 
the X coordinate of the first 


point (O through 479). 


I 


Bytes 4 and 5 The binary value of the b bits is 
the Y coordinate of the first 


point (0 through 287). 


More X and Y coordinates can follow until an End- 
of-Data order is encountered. If there are more X 

and Y coordinates than will fit in a write block, use 
the More-Data-to-Come order described earlier in 
this chapter. 
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Example: The following Draw Polyline order will 
draw the polyline shown below: 


Byte 


1 2 3 4 5 6 7 8 9 10 11 12 13 14 


lalo'alolalolalolalalals lela alo| lala alsle|alols|s'9 2| 


eee roe 
i 
Draw I End 
I 
Polyline 1 ! of 
Order ; Data 
XO X479 
Y287 —— 


Yo—— 


Xa =0 
Ya=10 
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Draw Scanline Order 


Function: The Draw Scanline order allows the pro- 
grammer to set individual PELs on a specified scan 
line. The scan lines are numbered starting at the 
bottom of the screen with scanline 0 to the top of the 
screen with scanline 287. The Draw Scanline order is 
followed by graphic data bytes that specify where the 
X and Y coordinates start, and these are followed by 
graphic data bytes that indicate which PELs to set. 
The PELs are either set to the current color using 
current function or left alone. 


Format: 


Byte 1 Byte 2 Byte 3 Byte 4 
Graphic Order Graphic Data Graphic Data Graphic Data 


Byte 5 Byte 6 Through n 
Graphic Data PEL Pattern 


Byte 1 = This is the Graphic order for the 
draw scanline. 


Bytes 2and3 = _ The binary value of the a bits is 
the X coordinate of the first 
point (0 through 479). 


Bytes 4 and 5 =_ The binary value of the b bits is 
the Y coordinate of the first 
point (0 through 287). 


Bytes 6 thrun = The bit pattern of bytes 6 thru n 
determines which PELs will be 
set and which PELs will be left 
as is. If the bit is: 1 = set the 
PEL using current color and 
function; 0 = do not change the 
PEL. 


More scan line pattern bytes can follow until an 
end of data is encountered. If there is more data 
than will fit in a write block, use the More-Data-to- 
Come order described earlier in this chapter. 
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Example: The following example bytes 6 and 7 will 
result in the following scanline pattern being drawn 
at the coordinates defined in bytes 2 through 5. 


Byte 6 Byte 7 
Graphic Data Graphic Data 


3 PELs are set using current 
color and function. 


5 PELs are left unchanged. 


4 PELs are set using current 
color and function. 


Write Polymarker Order 


Function: The Write Polymarker order will write the 
polymarker defined in the previous Set Marker order 
at the coordinates specified in the graphic data bytes 
of the Write Polymarker order. 


Format: 


Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 
Graphic Order Graphic Data Graphic Data Graphic Data Graphic Data 


Byte 1 = This is the Graphic order for the 
draw polymarker. 


Bytes 2 and3 =_ The binary value of the a bits is 
the X coordinate. 


Bytes 4and5 = _ The binary value of the b bits is 
the Y coordinate. 


More X and Y coordinates can follow until an end 
of data is encountered. If there is more data than 
will fit into a write block, use the More-Data-to- 
Come order described earlier in this chapter. 
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Fill Polygon Order 


Function: The Fill Polygon order constructs a 
polygon from the X and Y coordinates in the graphic 
data bytes and fills the polygon, using fill mode and 
reference line as defined in the previous Set Fill 
Mode order. The last vertex is combined with the 
first vertex to form the last edge. 


Restrictions: 
1. The edges of polygons can touch but not cross. 


2. The maximum number of nonhorizontal shield 
area and fill area edges is 128. 


Format: 


Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 
Graphic Order Graphic Data Graphic Data Graphic Data Graphic Data 


Byte 1 = This is the Graphic order for the 
fill polygon. 


Bytes 2 and 3 = __ The binary value of the a bits is 
the X coordinate of the first 
point (0 through 479). 


Bytes 4 and 5 The binary value of the b bits is 
the Y coordinate of the first 


point (0 through 287). 


More X and Y coordinates can follow until an End 
of Data order is encountered. If there is more data 
than will fit in a write block, use the More-Data-to- 
Come order described earlier in this chapter. 
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Example: The following Fill Polygon order will draw 
the polygon shown below and fill the polygon using 
the fill mode and reference line from the previous Set 
Fill mode, Set Style, and Set Function orders. In this 
example, the fill mode and reference line had been 
set to draw solid boundary and fill with +45 degree 
lines. 


Byte 


123 4 5 6 7 8 9 10 11 12 13 14 


lals'alolalolalolalalal: le[4lo| lala 2 s|6/alols|9'9|2| 
| 


I 
I Polygon filled using +45 : 
een ee ; at 

: I 
degree reference line | end 


Fill I : 
Polygon | ! of 
Order ; Data 


XO X479 


Define Shield Area Order 


Function: The Define Shield Area order allows the 
programmer to define an area that will be shielded 
from the next Fill Polygon order. The shield area is 
defined in the graphic data bytes that follow the 
order. The Fill Polygon order does not have to imme- 
diately follow the Define Shield Area order; however, 
the next Fill Polygon order deletes previously defined 
shield areas after they have been processed. Shield 
areas may be defined within shield areas, and the 
result will be reverse shielding (no shield). 


Restrictions: 
1. The edges of polygons can touch but not cross. 


2. The maximum number of nonhorizontal shield 
area and fill area edges is 128. 
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Format: 


Byte 1 Byte 2 Byte 3 Byte 4 
Graphic Order Graphic Data Graphic Data Graphic Data 


Byte 5 
Graphic Data 


Byte 1 = This is the Graphic order for the 
define shield area. 


Bytes 2 and3 = _ The binary value of the a bits is 
the X coordinate of the first 
point (0 through 479). 


Bytes 4 and 5 = _ ‘The binary value of the b bits is 
the Y coordinate of the first 
point (0 through 287). 


More X and Y coordinates can follow until an End 
of Data order is encountered. If the data will not fit 
a write block, use the More-Data-to-Come order 
described earlier in this chapter. 


Example: The following Define Shield Area order 
will draw the shield area shown below. After the 
shield area is defined, a polygon can be drawn 
around the shield and filled; the shield area will be 
unaffected by the fill. 


Byte 


12 3 4 5 6 7 8 9 10 11 12 13 14 


6'4/0|7/2/4lol4alFl4i1/6| 4] 4/0] 7] 2/4] 21 5/6) 4alols|9' 9/2 
l i 


— J 
Define End 
Shield l of 
Area Data 
Order Order 

{ 


Shield Filled 
Area Polygon 
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Read Orders 
Graphic Read orders allow graphic data to be written 


to the A/N display buffer so it can be read by the host, 
using normal 5250 Read commands. 
Used with End of Data 


Graphic 
Byte This Order |Required Description of Data 


Data Bytes 


Read Status Order The 20 data bytes written to the A/N buffer on the 
read status order have the following format: 
Function: The Read Status order writes 20 bytes of 


graphic status information to the A/N display buffer Position Status Data Description 
address specified by the 2 graphic bytes that follow 
the order. 1,2 Two-byte error code of the last graphic 
error detected. These codes are 
Format: described later in this section under error 
handling. 
Byte 1 Byte 2 Byte 3 
Graphic Order Graphic Data Graphic Data 3,4 (5292 Model 2 identification). 
5 Printer type. 
6,7 If error pending, these 2 bytes are the 


Byte 1 = This is the Graphic order for the 
read status. 


offset into the graphics write block where 
the error was detected. 


Bytes 2 and3 = _ The binary value of the a bits is 
the offset on the A/N display 
screen where the status data 


- 20 Reserved. 


will be written. This value can I/O Feature Printer Orders 

be 0 through 1919. The binary 

value of 0 represents row 1, Printer orders control the printing of graphics infor- 
column 1 on the A/N display mation and control the color tables for A/N and 
screen. graphics information for the screen copy function. 


The programmer can use Printer orders to: 


e Pass data received from the host directly to the 
printer interface. 

e Pass display screen data to the printer interface 
for screen copy. 

e Load the Printer Color Mix Table for A/N Screen 
Copy. 

e Load the Printer Color Mix Table for Graphics 
Screen Copy. 

¢ Set the duration of the printer error time-out. 


2-98 


C 


The following chart summarizes the I/O Feature 


Printer orders. A detailed description of each order 


follows the chart. 


Data Bytes 


Graphic Used with 


Byte This Order 


Printer Data Follows Co 
Screen Copy C1 


Load A/N Color Mix C2 
Table 


Load Graphics Mix Table |C3 


Set Printer Time-out 


The following paragraphs describe the printer orders. 


Printer Data Follows Order 


Function: This order allows printer data that can be 


variable in length to be passed to the printer inter- 


face from the host. Printer data is described later in 


this chapter. 


Format: 


Byte 1 Byte 2 through n 
Printer Order Printer Data 


Byte 1 = This is the Printer order for the printer 
data that follows. 


Data that follows this order will be processed as 
printer data until an end of data is encountered. If 
the data spans write blocks, use the More-Data-to- 
Come order described earlier in this chapter. 


Block 
End of Data |Spanning 
Required Allowed Description of Data 


Printer data 


Table index value 


Table index value 


Time-out value 


Screen Copy Order (This order is supported under a 
printer RPQ only.) 


Function: The Screen Copy order causes the printer 
to provide hard copy output from the A/N buffer and 
the graphic bit map. 


Format: 


Byte 1 
Printer Order 
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Load Printer A/N Color Mix Table Order 


Function: The Load Printer A/N Color Mix Table 
order for screen copy maps the A/N display attributes 
into 16 possible colors. These colors are created by 
the printer, mixing black, cyan, magenta, and yellow. 
This order allows the default table to be changed by 
the host. 


Format: 


Byte 1 Byte 2 Byte 3 
Printer Order 


Order Data Order Data 


Black 


Byte 1 = This is the Printer order for Load Printer 
A/N Color Mix Table. 


Byte 2 = The binary value of the a bits is the color 
index to be changed. 


I 


Byte 3 = The bemy bits are the new bemy values to 


be used. 


Data associated with this order will be processed as 
color table changes until an end of data is encount- 
ered. If the data spans blocks, use the More-Data-to- 
Come order described earlier in this chapter. 


The following chart summarizes the default values for 
the Printer A/N Color Mix Table. 


Default 

A/N Value Color 
Color Index Attribute (BCMY) Printed 
0 20 1000 Black 
1 21 1000 Black 
2 22 0101 Green 
3 23 0101 Green 
4 24 1000 Black 
5 25 1000 Black 
6 26 0101 Green 
7! 2/ 0000 None 
8 28 0010 Magenta 
9 29 0010 Magenta 
10 2A 0010 Magenta 
11 2B 0010 Magenta 
12 2C 0010 Magenta 
13 2D 0010 Magenta 
14 2E 0010 Magenta 
15! 2F 0000 None 
16 30 0100 Cyan 
17 31 0100 Cyan 
18 32 0001 Yellow 
19 33 0001 Yellow 
20 34 0100 Cyan 
21 35 0100 Cyan 
22 36 0001 Yellow 
23' 37 0000 None 
24 38 0011 Orange 
25 39 0011 Orange 
26 3A 0110 Violet 
27 3B 0110 Violet 
28 3C 0011 Orange 
29 3D 0011 Orange 
30 3E 0110 Violet 
31! 3F 0000 None 


‘Cannot be changed by host. 
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Load Printer Graphics Color Mix Table Order 


Function: The Load Printer Graphics Color Mix 
Table order for screen copy maps the color index 
number used for creating the display to 16 possible 
colors. These colors are created by the printer 
mixing of black, cyan, magenta, and yellow. This 
order allows the default table to be changed by the 
host. 


Format: 


Byte 1 Byte 2 Byte 3 
Order Data 


Printer Order Order Data 


Black 
This is the Printer order for Load Printer 
Graphics Color Mix Table. 


Byte 1 


Byte 2 = The binary value of the aaa bits is the color 
index number to be used. 


Byte 3 = The bemy are the new bemy values to be 


used. 


The data associated with this order will be processed 
as table values until an end of data is encountered. If 
the data spans blocks, use the More-Data-to-Come 
order described earlier in this chapter. 


The following chart summarizes the default values for 


the Printer Graphics Color Mix Table. 


Default 

Color Value Color 
Index (BCMY) Printed 
0 0000 None 

1 0010 Magenta 
2 0101 Green 
3 0110 Violet 
4 0011 Orange 
5 0001 Yellow 
6 0100 Cyan 

7 1000 Black 


Set Printer Time-out Order 


Function: The Set Printer Time-Out order allows the 
programmer to vary the time-out value for a P1, P2, 
or P4 printer error. The time-out is the amount of 
time between the detection of a P1 or P2 error and 
the moment when processing is halted and the error 
is reported to the host. This time-out period also 
determines the maximum time the printer can be 
busy before processing is halted and a P4 error is 
reported to the host. The data byte associated with 
this order specifies the number of time units for the 
time-out. One time unit is 5.5 seconds. 


Default: The default value for this order is hex 03 (3 
X 5.5 seconds). 


Format: 


Byte 1 Byte 2 
Printer Order 


Printer Data 


This is the Set Printer Time-Out order 
The a bits are the binary value of the 
units of time. The maximum time-out 
value is 5 minutes and 45 seconds (63 X 
5.9): 


Example: The following Printer order and data byte 
will set the time-out value to 22 seconds. 


Byte 1 Byte 2 
Printer Order Printer Data 


Time-out value is 
4x 5.5 = 22 seconds. 
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I/O Feature IEEE-488 Interface Orders 


The IEEE-488 interface feature provides for two order 
types. The Set orders allow static information to be 
established, and the Local Command orders allow 
the dynamic commands to be processed. 


Data Bytes 
Graphic Used with /|End of Data 
Byte This Order |Required Description of Data 


Set Address IEEE address 

Set Talker Time Out Time-out value 
Set EOI Mode EOI mode 

IEEE Data Follows Pass through data 
Go to Standby 

Remote Enable 

Remote Disable 

Interface Clear 


The description of the IEEE-488 orders in this section Set Talker Time-out Order 
assumes a working knowledge of the IEEE-488 stand- 
ards. Function: The Set Talker Time-Out order sets the 


talker time-out to the specified number of seconds. 
Set Address Order 

Format: 
Function: The Set Address order sets the 5292 
Model 2 IEEE address. Byte 1 Byte 2 Byte 3 


IEEE Order IEEE Data IEEE Data 
Format: 


Byte 1 Byte 2 


lEEE Order IEEE Data Byte 1 = This is the IEEE order for the set 
talker time-out. 
Bytes 2 and3 = The a bits are the binary value in 
seconds (0 to 511) to be used for 
Byte 1 = This is the IEEE order for the set address a talker time-out (0 = no 
Byte 2 = Thea bits are the binary value of the 5292 time-out). 


Model 2 address (0-30). 
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Set EOIl-Mode Order 


Function: The Set EOl-Mode order sets the end or 
identify mode on or Off. 


Format: 


Byte 1 
IEEE Order 


Byte 2 
IEEE Data 


Byte 1 = This is the IEEE order for set EOI mode. 
Byte 2 = Thea bit value is 

1 = EOI mode on 

0 = EOI mode off. 


IEEE Data Follows Order 


Function: The IEEE Data Follows order causes the 
direct pass through of IEEE data. IEEE data is 
described later in this chapter. Data following this 
order will be passed through until an end of data is 
encountered. If the data spans blocks, use the More- 


Data-to-Come order described earlier in this chapter. 


Format: 


Byte 1 
IEEE Order 


Byte 2 through n 
IEEE Data 


Take Control Asynchronously Order 

Function: This order causes the 5292 Model 2 to 
send the ATN line TRUE (Take Control Asynchro- 
nously) on the IEEE-488 bus. 


Format: 


Byte 1 
IEEE Order 


Go-To-Standby Order 

Function: This order causes the 5292 Model 2 to 
send the ATN line FALSE (Go-to-Standby) on the 
IEEE-488 bus. 


Format: 


Byte 1 
IEEE Order 
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Remote Enable Order 
Function: This order causes the 5292 Model 2 to 
send the Remote Enable Auxiliary command on the 


[EEE-488 bus. 


Format: 


Byte 1 
IEEE Order 


Remote Disable Order 
Function: This order causes the 5292 Model 2 to 
send the Remote Disable Auxiliary command on the 


iEEE-488 bus. 


Format: 


Byte 1 
IEEE Order 


Interface Clear Order 
Function: This order causes the 5292 Model 2 to 
send the Interface Clear Auxiliary command on the 


IEEE-488 bus. 


Format: 


Byte 1 
IEEE Order 


Printer and IEEE Data 


Data associated with the Printer Data Follows order 
and the IEEE Data Follows order must be sent to the 
5292 Model 2 in pairs. Data for one order may span 
graphic write blocks by using the graphics More- 
Data-to-Come order. 


Format: 


Bytes 1 and2 = _ The bits 0 through 7 represent the 
data. Note that bit 7 is the most 
significant bit. 


Printer and IEEE data will be processed until an end 
of data is encountered. 
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Error Handling 


When an online error is detected during graphics 
processing, the error can be classified as either 
recoverable or nonrecoverable. The action taken by 
the 5292 Model 2 is somewhat different for these two 
types of errors. The following topics describe the 
events for each type of error. 


Recoverable Errors 
The following graphic error is recoverable: G5 


The following events take place when a recoverable 
type error is detected. 


1. The 2-digit error code is displayed on the status 
line of the 5292 Model 2 Display. 


2. The alarm will sound for approximately 400 milli- 
seconds. 


3. Graphics processing will continue with the next 
byte in the graphics write block. 


4. The graphics Aid key code Cmd-9 will be sent to 
the host when the graphics write block has com- 
pleted processing. 


Non-Recoverable Errors 
The following graphic errors are nonrecoverable: 


G1 P1 Et 
G2 p2 E2 
G3 P3 E3 
G4 P4 E4 

P5 E5 


The following events take place when a nonrecover- 
able error is detected when processing a graphic 
write block: 


1. The 2-digit error code is displayed on the status 
line of the 5292 Model 2 Display. 


2. The alarm will sound for approximately 400 milli- 
seconds. 


3. Graphics block processing will be terminated. 
4. Graphics mode will be terminated. 


5. The graphics Aid key code Cmd-10 will be sent to 
the host. 


Printer Soft Error 


There are two printer errors, P1 and P2, that allow 
you to take corrective action before the error 
becomes nonrecoverable. The time allowed to take 
corrective action can be changed by using the Set 
Printer Time-Out order; the default is 16.5 seconds. 
The following events take place when a P1 or P2 
error is detected: 


1. The 2-digit error code appears on the status line. 

2. The alarm sounds. 

3. The 5292 Model 2 will wait for the error to be cor- 
rected for the amount of time specified in the 
time-out period. 

4. Ifthe error is not corrected during the time-out 


period, graphics processing is terminated and the 
graphics Aid key code Cmd-10 is sent to the host. 
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Two-Digit Graphic Error Codes 


Two-digit graphic error codes that further define a 
graphic error are displayed on the status line of the 
5292 Model 2 Display Screen, and also are available 
to the programmer by using the Read Status Graphic 
order. The 2-digit codes are summarized in the fol- 
lowing chart. 


Possible Cause 


—"s 


Invalid graphic byte Invalid data byte format. 
MDTC order received with no preceding data. 
Data byte detected when expecting an order. 


Undefined order Order code received which is not supported. 
Invalid graphic set Set color table index = 0. 

order data Set marker > 8. 

Fill polygon error The number of nonhorizontal fill edges > 128. 


Marker outside display |Center coordinate will not allow entire marker to be drawn. 
boundaries 


Printer not ready No paper in printer. 
Printer is not powered on. 
Printer is not attached. 


Printer not selected Printer is offline. 
General printer error |Printer hardware error. 
Time-out error Printer remains busy for longer than the time-out period (default = 1615 seconds). 


Invalid printer control |Load Printer A/N Color Mix Table index = 7, 15, 23, or 31. 
order data 


E1 IEEE bus error IEEE device is not powered on. 

IEEE device is not attached. 

No interface message was received which assigned a listen address. 

No address match between a powered on JEEE device and an assigned listen 
address. 


Talker error No interface message was received which assigned a listen address. 


Invalid IEEE address |Set address = 31. 
Time-out error No interface clear order was received after powering on. 
No interface clear order was received following an E1 order. 


Listen mode attempted |Interface message was received which assigned a 5292 Model 2 to listen. 


2 
3 


4 
5 


ook 


z 


we) 


BAN 


” 
@ 
+ 
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Pacing 


The 5292 Model 2 uses pacing to prevent long 
running graphic operation from tying up the work 
station controller or causing a work station controller 
time out. Pacing is accomplished by resetting busy 
when a graphic write block is received at the 5292 
Model 2 and sending graphic Aid key codes when a 
write block has completed processing. The following 
paragraphs contain a description of pacing and the 
graphic Aid key codes used to accomplish pacing. 


Pacing Description 


The pacing described below frees up the work station 
controller and prevents transmission of the next 
graphics write block until the current graphics write 
block has been processed. 


1. Data is sent from the host system using normal 
5250 Write commands. Other 5250 commands 
have no relation to graphics processing. 


2. The first byte in a write block, being hex FF, turns 
on graphics mode, and the following bytes for 
that write block will be saved in the graphics 
buffer. The maximum length of a graphic write 
block is 256 bytes and the minimum length is 11 
bytes. If the graphics mode is off and the first 
byte is not hex FF, the data will be written to the 
appropriate address of the alphanumeric buffer. 
Graphics and alphanumeric data may not be 
mixed within a single write block. The 5292 
Model 2 continues processing write blocks as 
graphic blocks while in graphics mode until the 
End of Graphics Mode order is received or a non- 
recoverable error is detected. 


3. After receiving and saving a graphics write block, 
busy is immediately reset by the 5292 Model 2 to 
avoid a work station controller time out. A 
graphics block will be processed only during idle 
time and may be interrupted by another 5250 
command from the host. When the graphics 
block has completed processing, a graphic Aid 
key code is sent to the host system to indicate the 
status of the processing. 


The host must not send another graphics block 
until a graphics Aid key is received from the ter- 
minal. If a write block is received at the 5292 
Model 2 while a previous graphic block is being 
processed, the write block is assumed to be 
alphanumeric. 


Local keyboard select options will be processed 
as normal while in graphics mode; otherwise, the 
keyboard is locked. 


System graphics reset (first two bytes of a write 
block hex FFFF) can be used by the programmer 
to put the 5292 Model 2 into a known condition. 
System graphics reset terminates graphics proc- 
essing, ends graphic mode, and returns a graphic 
Aid key code (Cmd-8) to the host. 
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Graphic Aid Key Codes 


Graphic Aid key codes are sent to the host system to 
indicate the completion status of graphic processing. 
Unless suppressed by the Suppress Pacing 
Response order, a Graphic Aid key code is sent to 
the host for every graphic write block that is received 
by the 5292 Model 2. A summary of the Graphic Aid 
key codes and a description of the status is shown 
below. 


Graphic Aid Scan Codes 
Key Sent (Hex) |Description of Status 


Cmd-12/24 6F 3C Graphics block processing completed successfully with no errors. 

Cmd-11/23 6F 3B Graphics processing and graphics mode terminated at the 5292 Model 2 by the 
operator using local keyboard select option. 

Cmd-10/22 6F 3A Graphics block processing and graphics mode terminated following detection of 
an error. 


Cmd-9/21 6F 39 Graphics block processing continued and completed successfully after detecting 
an error. 

Cmd-81/20 6F 38 Graphics processing and graphics mode terminated after receiving a system 
graphics reset from the host. 


Cmd-7/19 6F 37 Reserved. 
through 
Cmad- a CC 6F 31 


1Cmd 8 is never fCmd8isneversuppressed. 
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I/O Feature Information 


The 5292 Model 2 has connectors for three I/O fea- 
tures on the back of the machine. The I/O features 
supported are: 


e {EEE-488 digital interface for plotters. 

e Video interface for video film camera or video 
monitor. 

e Parallel printer interface. 


The implementation of each I/O feature is discussed 
in the following paragraphs. 


IEEE-488 Digital Interface for Plotters 


The plotter implementation on the 5292 Model 2 con- 
forms to ANSI/IEEE-488 1978 specifications. Con- 
nection of the IEEE bus is by way of the parallel port 
connector on the back of the 5292. 


The IEEE-488 functions implemented on the 5292 
Model 2 are: 


e Source handshake (SH1). 

e Acceptor handshake (AHO). 
e Talker (T4). 

e Listener (LO). 

e Service request (SRO). 

e Remote local (RLO). 

e Parallel poll (PPO). 

e Device clear (DCO). 

e Device trigger (DTO). 

e Controller (C1 through C4, C28). 
e Electrical interface (E1). 


Video Interface 


The 5292 Model 2 video implementation provides the 
following signals at the video connector. 


Video Outputs 
There are three color-coded noncomposite video 


Outputs at the connector (red, green, and blue) and 
one composite SYNC output. 


Color Voltages (into 75 ohm load) 

Red 1.1 plus or minus 36% volts P-P 

Green 1.1 plus or minus 36% volts P-P 

Blue 1.1 plus or minus 36% volts P-P 

Sync 0.9 plus or minus 8% volts P-P negative 
going 


Synchronizing Rates 


Horizontal scan frequency: 15,724 KHz 
Vertical trace frequency: 2:1 interface 


1. Field frequency: 93.32 Hz 


2. Frame frequency: 46.66 Hz 
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Sync Timing Horizontal Blanking Internal 


Video Output 


1 Volt ee 
0 Volt 
HBW ——____ | 


Sync Output 


HEP — 
0 Volt 


—e| Hew | 


HBW Horizontal blanking width = 12.7 microseconds 
HFP Horizontal front porch = 1.7 microseconds 
HPW Horizontal sync pulse width = 5.1 microseconds 
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Sync Timing Vertical Blanking Internal 


Video Output 
Transition from Even to Odd Field 


1 Volt i De 
0 Volt 
VBWE——»} 


Sync Output 
Vertical Only 
Shown 


0 Volt = ar —- 


Video Output 
Transition from Odd to Even Field 


1 Volt ee 
0 Volt 
VBWO —______+| 


Sync Output 
Vertical Only 
Shown 


1 Volt ot 
0 Volt oe Jon es 


VBWE Vertical blanking width, even field = 1.52 milliseconds 
VBWO Vertical blanking width, odd field = 1.58 milliseconds 


VFPE Vertical front porch, even field = 633 microseconds 
VFPO Vertical front porch, odd field = 665 microseconds 
VPW Vertical sync pulse width = 190 microseconds 
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Parallel Printer Interface 


The parallel printer interface connector on the back 
of the 5292 Model 2 can be used to connect a 
graphics printer. The following paragraphs describe 
the interface in the following sequence: 


1. 


Signal names 
Signal timings 


5292 processing order for handshake 


Signal Names 


The connector is a D-type 25-pin receptacle (DB-258 
Amphenol) shown below: 


The pin numbers and signal names are shown in the 
Printer commands. following chart. The names in parentheses are the 
5292 names of the printer signal. 


Pin 
Number 


CONDO OAR WDM — 
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Signal Name 


-Strobe 

DO 

D1 

D2 

D3 

D4 

D5 

D6 

D7 

-Acknowledge 

+ Busy 

+P.E. (+ paper out) 

+ Select (+ enabled) 
-Autofeed (not connected) 
-Error (+ online) 

-Reset 

Select input (not connected) 
Ground (not connected) 
Ground 

Ground 

Ground 

Ground 

Ground 

Ground 

Ground 


J 


Signal Name Definitions 


e DOthrough D7: These are the data lines to the 
printer (unidirectional). DO is the least significant 
bit and D7 is the most significant bit. 


* -Strobe: This is a control signal to the printer 
(unidirectional) that indicates when valid data is 
available on the data lines. This control tells the 
printer to input a data byte. 


e +Busy: This is a control signal from the printer 
(unidirectional) that indicates that the printer is 
performing an internal task and cannot receive a 
-strobe. 


e -Acknowledge: This is a control signal from the 
printer (unidirectional) that indicates that the pre- 
vious data byte received via a -strobe pulse was 
successful and another data byte can now be 
received. 


e +Paperout: This is a control signal from the 
printer (unidirectional) that indicates the printer 
is out of paper and cannot continue to print. 


e -Error(+online): This is a control signal from 
the printer (unidirectional) that indicates a printer 
error condition exists and the printer is not 
online. 


e +Select (+ enabled): This is a control signal 
from the printer (unidirectional) that indicates the 
printer will execute all printer commands. This 
condition is necessary to print data sent to the 
printer. 


e -Reset: This is a control signal sent to the printer 
(unidirectional) that indicates the printer will be 
initialized to power on condition. 

e Ground: These connections are used for signal 
return paths and electromagnetic noise reduction 
(shielding). 


« -Autofeed: The 5292 does not use this signal. 


e -Select input: The 5292 does not use this signal. 
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Signal Timings 


The following signal timings must be met or 
exceeded by the 5292 and the printer. 


Strobing Data to the Printer 
Data 
DO-D7 


-Strobe 


—— 0.58 ——elee— 115 el —— Tus —! 


Minimum Minimum Minimum 


Resetting the Printer 


~-Reset a (ee i 
|+-50 ps -»| 


Minimum 


Printer Receiving the Data 


ac | a ee in 


+Busy ) 
—— 1 pele O to Printer’ 6 us 


Maximum  Time-out Value Minimum 


Printer Acknowledging Data 


Cig Ns 


-Acknowledgment 


Leg 
5us ——> 
Maximum 
ae 1 
Tus Minimum 
Sus Maximum 


ACK Pulse Width 


1 
This time is printer determined. 


The +paperout, -error (+ online), and +select 
(enabled) lines are all asynchronous and assert their 
Signal level for as long as the condition exists. 
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5292 Processing Order for Handshake 


The following sequence describes how the 5292 
handshakes the printer during data follows or screen 
copy. Before any printer data is sent to the printer, 
the following sequence must occur. 


Check for + paperout (P1 error) 
Check for + online (P2 error) 

Check for + enabled (P3 error) 

Check for + busy (time-out causes P4) 
Check for -acknowledge (P3 error) 

Put printer data on the bus 

Send -strobe. 


he? OL et tee 


Printer Commands and Data 


Printer commands and printer data are sent to the 
printer by two possible methods: 


1. Printer Data Follows order from the host system 


2. Screen Copy order and screen copy select option 
from the keyboard. 
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The following commands are sent to the printer when 
a screen copy is performed by the 5292 Model 2 
microcode. The 5152 Printer uses only the items 
marked with an asterisk. 


Hexadecimal 


*Carriage Return 


ale 
= |3 
3 | 3 
i | et) 
o 1a 
Q. 

‘@) 


] 
a. 
1) 


Select Printer 
“Command Prefix (escape) |1B 
*Print from Table 2 1B 36 


Select 12 CPI 1B 3A 


_" 


“Execute Vertical Spacing |1B 4A n nN = spacing factor 


5152 = 1/216 inch 
other = 1/144 inch 


n = 00 OFF 


1B 641h 1h = 1/120 inches 


1B 6E n n = 00 5:6 
n = 01 1:1 


*Standard Graphics 
IDS Unique Deselect 
Undirectional On/Off 


Black Ribbon Band 
Cyan Ribbon Band 


Relative Forward 
Positioning 


Magenta Ribbon Band 


Print Aspect Ratio 


Yellow Ribbon Band 1B 79 
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a Keys Aid-Generating Keys 


The aid-generating keys or key sequences are (see 


The basic types of keys on either of the keyboard 
Figure 2-4): 


types are: 
¢ Alphameric keys (typewriter-like in nature; | * Clear (may be a sequence of key actions) 
including letters, numbers, and special charac- 


ters) * Enter/Rec Adv 


¢ Numeric keys; these are used for entering * Help (from nonerror state) 


numeric data only 
¢ Command Function 1 through 24 


e Special function keys: 
e Print 
— Aid-generating 


— Cursor movement * Record Backspace Function. 


— Field exit 

— Signal Note: Record Backspace is not a key; it is a func 

— Special control tion performed by the operator using the Home 

— Special host. key when the cursor is at the home position. 
The following text describes the special function * Roll 7 (Roll Up or Page Down) and Roll | (Roll 
keys. Down or Page Up). 
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Data Entry Keyboard (5251 and 5291) 


Seunseeceucccas 
SWeTOQTIOIOOE|S 
Ganeosnnsncense 
C= OOO EOOH000E3 


Typewriter-like Keyboard (5251, 5291, and 5292) 


Basar | 7] N 7 7 x 7 7 
Mode ; 
t r “> 


98 COSCGeGOoooOoTC=ae 
QE OEOOOMOOOOMOO=OOAS 
Scmaesocoooouccsesulonn 
3 MOOWOOOOOOOOMA008 
AA C=C jg 20 


apes mth 
E | 


IBM Enhanced Keyboard 
Ne) (e (ele) 


AEA RRAHA AAA E=| HE) 
AAAAAAAAAE 7 
DAIRY) AIRE 
atl 
2 a ru 


(PII 
ia 


122-Key Keyboard 


ene semaece ss 


APREAAASASES 
AEARARaARAAREeS aaq epa_A 
PEPE LOCEECL LR) O66 Cnr 
AE) AOR OAR AMA OPE alae 
BBQRABAAAAHAr | age OFFE 
ABE Bo) mal 


Figure 2-4. Aid-Generating Keys 
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The aid-generating keys (when pressed) generate aid 
codes that go in the display data stream to the host 
system in response to the LU-LU read commands. 
They alert the host system that the controller requires 
some action. These keys are not operational when 
the keyboard is locked, or when the cursor is in an 
active, right-adjust field. When the keys are opera- 
tional, they lock the keyboard, and depending on the 
key that was pressed, the aid code either goes imme- 
diately to the host system if a read command is 
pending, or is kept pending until the controller 
receives a Read command; when this happens, the 
aid code is sent to the host system in the normal FM 
LU-LU flow. 


The following text describes the functions of the aid- 
generating keys. 


Clear (For all Displays except the 3180 and 3196) 


Clear is not a key but rather a sequence of key 
actions that consists of the following: 


1. Press and release the Cmd key. 


2. Press and hold the {? (Shift) key on the 
typewriter-like keyboards; press the Numeric 
Shift key on the data entry keyboards. 


3. Press andrelease the ~«—— (Character Back- 
space) key on the typewriter-like keyboard or the 
rightmost blank key on the top row of the data 
entry keyboards. 


Clear (For the 3180 and some 3196 Displays) 
1. Press and hold the Alt key. 
2. Press the Clear key. 


Clear (For 3196 Displays with an IBM Enhanced 
Keyboard) 


Press the Clear key. 


The session environment determines the results of 
the Clear function: 


e If the LU is not involved in a session, it clears the 
entire display regeneration buffer (fills it with 
nulls and selects format level 0). See the index 
entry format level 0 for details. 


e Ifthe LU is involved in a session, Clear issues 
the aid code hex BD, which requests that the host 
system issue a Clear Unit command to the LU to 
clear the display. See the index entry Clear Unit 
command. 


Enter Rec/Adv 


In the normal unlocked state, when the operator 
presses the Enter/Rec Adv (Enter/Record Advance) 
key, the following occurs: 


1. The controller checks for the completion of man- 
datory fill, self check, and right-adjust fields when 
in an active field. (An active field is one in which 
the operator has begun entering data.) Ifthe 
requirements of the field have not been satisfied, 
an error OCCurs. 


2. The controller locks the keyboard. 


3. Ifthe master MDT bit is on, the controller checks 
for unentered mandatory enter fields, positions 
the cursor where there is such a field that is 
unentered, and posts an operator error. 


4. Assuming there is a read command and CD, the 
controller sends the cursor address, aid code, 
and data in the input fields to the host system. 
This is the data formatting it does: 


a. Sets the zones on signed numeric fields. 

b. Sends the entire input field and changes nulls 
to blanks on the Read Input command. 

c. Strips trailing nulls from the fields and 
changes leading and embedded nulls to 
blanks for the Read MDT command. 

d. Resequences the field as specified by the 
field control word. See the index entry field 
control word for details. 


Note: When the host system unlocks the keyboard, 
the cursor goes to the address specified by the IC, to 
the first nonbypass field if no IC is specified, or to row 
1, column 1 if neither of these is given. 
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Help 
(See also Signal Keys within this topic.) 


If the display is not in an operator-error state, and the 
operator presses the Help key, the display issues a 
hex F3 aid byte to the host system. If, however, the 
operator presses the Help key after having used the 
Cmd key or the Sys Req key, an error results. 


Command Function 1-24 


The command function keys are those that the oper- 
ator accesses by first pressing Cmd and then one of 
the 24 numeric keys across the top of the keyboard. 
The functions of these keys are user-defined. 


Note: To access command function keys 13-24, press 
the Cmd key, then the Shift key on the typewriter-like 
keyboard or the Numeric Shift key on the data entry 
keyboards, and the appropriate numeric key. 


(Some keyboards have no Cmd key. They either have 
24 separate command function keys, or they have 12 
separate command function keys. In the latter case, 
to access command function keys 13-24, first press 
and hold a Shift key, then press the appropriate 
command function key.) 


In the normal unlocked state, when the operator 
presses a command function key, the controller: 


1. Checks for the completion of mandatory fill, self 
check. and right-adjust fields when the operator 
is keying in an active field. An active field is one 
in which the operator has begun entering data. 


2. Locks the keyboard. 


3. If the master MDT bit is on, checks for unentered 
mandatory enter fields, positions the cursor 
where there is such a field, and posts an operator 
error. 


4. Assuming there is a Read command and CD, 
sends the cursor address, aid code, and data in 
the input fields to the host system. This is the 
data formatting it does: 


a. Sets the zones on signed numeric fields. 
b. Sends the entire input field and changes nulls 
to blanks on the Read Input command. 


c. Strips trailing nulls from the fields and J 
changes leading and embedded nulls to 
blanks for the Read MDT command. 
d. Resequences the field as specified by the 
field control word. See the index entry field 
control word for details. 


Note: When the host system unlocks the keyboard, 
the cursor goes to the address specified by the IC, to 
the first nonbypass field if no IC is specified, or to row 
1, column 1 if neither of these is given. 


The associated Cmd aid byte is generated and sent to 
the host system preceding the first input field; 
sending the input fields can be inhibited by coding 
bytes 5-7 of the SOH order. See index entry SOH 
order. 


Print 


This key informs the host system that the operator 
wants to print the contents of the present display. See 
the index entry copy to printer feature. 


Record Backspace (Home) 


When the Home key is pressed with the cursor 
already at the home position, a record backspace is 
requested; the keyboard is locked and the aid code 
(nex F8) and cursor address are sent to the host 
system. The host system should respond by 
repeating the writing of the previous record to the 
display. 


Roll? (Roll Up) and Roll! (Roll Down) 
(Page Down = Roll Up and Page Up = Roll Down) 


These keys ask the host system to roll the informa- 
tion on the display. Roll Up issues aid code hex F5, 
and Roll Down issues aid code hex F4. The operator 
must first press a shift key, then the appropriate Roll 
key. 


The following conditions cause errors: 


1. Using a roll key after the Sys Reg key 

2. Using a roll key after the Cmd key 

3. Using a roll key when the display station is in the 
insert mode. 


J 
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Signal Keys 

The signal keys are: 

e Attn 

¢ Help (from error state). 
see Figure 2-5. 


The Signal keys cause a Signal command to go from 
the controller to the host system. The index entries 
signal command, command and response code list 
the pages that contain specific information about the 
contents of the Signal command. 


Attn 


This key is valid both when the keyboard is locked 
and when the keyboard is unlocked. Pressing the key 
does not affect the state of the keyboard or of the 
cursor position. The operator uses the key to alert 
the host system that a requested function (Such as 
Enter) is not being honored. 


Help (from Error State) 


During an error condition, the operator uses this key 
to request that the host system send data about the 
error to the display. The controller sends a Signal 
command to the host system containing columns 2-5 
(which is the error code) of the error line in the user 
bytes of the Signal command on the LU-LU flow. If 
the host programmer wants the operator to obtain 
explanatory information about the error when the 
operator uses the Help key, you must furnish this 
information. One way of doing this is with the Write 
Error Code command. (See the index entries signal 
command, command and response code; error 
states, and write error code command for details.) If 
the operator uses the Help key a second time, bytes 
2-5 of the error line return to the host system. 
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Data Entry Keyboard (5251 and 5291) 


Sesueuecoeucceigs 
IE eee ee ee 
C= JOGO OWOWOIOW IO 
= JWI OwOOI~J 


Typewriter-like Keyboard (5251, 5291, and 5292) 


G6 OOOOOOBOOOO0OTIC= 28 
Oe Scoccesovcersgicoos 
88 © IQOGOEROBO00HUGHBS 
O88 SOGOBODOSCOCMEVOR) 
O50 C=C Je 0Ce 10 


IBM Enhanced Keyboard 
(fell) 


ARAR AMAR MR AR E=| FIRE) BARE 
SEI OR A Ul ees 
UARARARAARARHHES BARE) 
pea sas sade poe aaa 
(yt FE} Be) ER 


122-Key Keyboard 


FIRPARAABBE 
Bearers 


Ty) 
(HL 
(OO) 


OMMDp 
CDOT 
[i 
S 
ei 
fs 
i 
i. 
ic 
i. 

i 
i. 
is 
rs 
i 

or 
(Conn 


Figure 2-5. Signal Keys 
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Special Control Keys 

The special control keys and key sequence allow the 

operator to alter operator-generated information on 

the display. They do not work when the keyboard is 

locked. See the index entry states. The following 

special control keys are for the 5251 and the 5252 

display stations. 

e Del (Delete) 

e Display Mode (key sequence) 

e Erase Input 

e Error Reset 

¢ Hex Key Function [<] on the typewriter-like key- 
board and {_} key on the data entry keyboard 
(the first key on the top row located to the right of 
the Cmd key) 

¢ Home 


e Ins (Insert) 


¢ (Shift) and O (Shift Lock) on typewriter-like 
keyboard 


‘ (Alpha) and (_~_ }) (Numeric) shifts on data 


entry keyboards. 
See Figure 2-6. 


In addition, these special control keys or key 
sequences are found on the 5291 Display Station: 


e Alternate cursor 


e Display cursor location. 
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Data Entry Keyboard (5251 and 5291) 
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Figure 2-6. Special Control Keys 
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Del (Delete) 


To use this key, first press and hold one of the shift 
keys, then press the Del key. (On some keyboards, 
the Delete key is by itself. If this is the case, do not 
press the Shift key first.) The result is a deleted char- 
acter in the position where the cursor was located. 
All remaining characters in the field then shift to the 
left to fill the column vacated by the deleted char- 
acter. 


Display Mode (Not Available on 5292, 3179, 3180 or 
3196) 


This is not a single key but rather a key sequence. 
Use the following sequence to enter display mode: 


1. Press the Cmd key. 
2. Press and hold the { (Shift) key. 


3. Press the ~ Grave Accent key on the typewriter- 
like keyboards or the leftmost blank key on the 
top row of the data entry keyboards. (The Grave 
Accent key is blank or has another character 
represented on some World Trade typewriter-like 
keyboards.) 


The display mode allows adjustment of the display to 
the operator’s preference. Normally, the display is 
light characters with a dark background; using 
display mode, the operator can change this to dark 
characters on a light background. 


Erase Input 


This key works only on the unprotected fields that the 
operator has modified. When the operator presses 
either 1) the shift key along with the Erase Input key, 
or 2) the Alt key along with the Erase Input key 
(depending on the keyboard type), all the modified 
fields are cleared to nulls and the cursor is moved to 
the insert cursor (IC) address specified in the last 
Write to Display command (see the index entries 
write to display command and /C order). The MDT bit 
remains on. If no IC has been specified, the cursor 
defaults to the first nonbypass field, or if there is no 
nonbypass field, to row 1, column 1 (the first input 
field). 


Error Reset 


Depending on the state of the system, pressing this 
key resets one of the following: operator error state, 
command mode, system request state, or insert 
mode. See the index entry states. During these 
states, using the Error Reset key restores the original 
data on the error line of the display and resets the 
state. Note, however, that during the operator error 
state, this key is not operational from the time the 
operator uses the Help key to the time he receives 
the Write Error Code command and contents from the 
host system. (The Write Error Code command and 
contents are issued by the host in response to the 
operator using the Help key.) 


Hex Key Function 


When display stations are connected directly toa 
controller in the host system, the Hex Key Function 
may not be supported. 


On keyboards having a Hex key, press and hold the 
Alt key, then press the Hex key to enter hexadecimal 
codes from the keyboard to generate any EBCDIC 
characters needed for input or display. On keyboards 
having a Cmd key, enter hexadecimal codes from the 
keyboard to generate any EBCDIC character needed 
for input or display as follows: 


Use the command function of the Grave Accent key 
on the typewriter-like keyboard or the first key on the 
top row (to the right of the Command key) on the data 
entry keyboards. 


Press the key for the first character of the 
hexadecimal code you want to enter (only 4 through 9 
or A through F are valid). 


Press the key for the second character of the 
hexadecimal code you want to enter (0 through 9 orA 
through F are valid). 


Note: FF is not a valid hexadecimal combination that 
can be entered on the display station. Diacritics 
entered in this manner cannot be combined with 
another character. 
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Home Alternate Cursor (5291 only) 3 


This key moves the cursor to the position specified by This is a key sequence. To enable this function: 
the insert cursor (IC) address. The IC is in the last 

Write to Display command. See the index entries 1. Press and hold the Cmd key. 

write to display command and /C order. If there is no 

IC order, the default is to the first nonbypass input 2. Press the Error Reset key. 

field or, if there is none, to row 1, column 1 (the first 

input field). If the cursor is already in the home posi- This function allows implementation of the bar type 
tion when the operator uses the key, the key func- cursor (aS opposed to the normal block cursor). To 
tions as the Record Backspace key. cancel this function, press the 1 key again. 

Ins (Insert) Special Host Keys 

This key sets the insert state for the field the operator The special host keys are Sys Req and Test Request 
is in. The state must be reset before the operator is (command function key sequence). See Figure 2-7. 


allowed to leave the field. (Using the Help, Reset, or 
Enter/Rec Adv key resets the state.) 


| © (Shift) and O (Shift Lock or Caps Lock) 


There are two Shift keys and one Shift Lock or Caps 

Lock key on the typewriter-like keyboard. The shift 

keys not only put the keyboard into an uppershift con- 

dition, but also act in conjunction with the Sys Req, 

Del, and Roll keys to perform special functions. See 

the index entry inhibit downshift function. van 


When pressed, the VU (Shift Lock) key sets the key- 
board in the uppershift condition, and this condition 
remains when the key is released. To unlock the key- 
board, the operator must press one of the two Shift 
keys. If the operator presses a Shift key along witha 
special function key, the inhibit downshift function 
may be enabled. If your keyboard has a Caps Lock 
key, press this key to get the upper case of alphabetic 
characters that are on separate keys. To temporarily 
leave Caps Lock mode, press and hold a Shift key 
while pressing a data key. To permanently leave 
Caps Lock mode, press the Caps Lock key again. 


(Alpha) and ( ™ ) (Numeric) Shifts 


There are two shift keys on the data entry keyboards. 
The Alpha Shift key puts the keyboard into lower shift 
when the operator wishes to select lower symbols on 
the keytop in a programmed numeric field. The 
Numeric Shift key is used to select upper symbols on 
a keytop when in a programmed alpha field and also 
to select upper shift command functions. 


There is no Shift Lock on the data entry keyboards. J 
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Data Entry Keyboard (5251 and 5291) 
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Figure 2-7. Special Host Keys 
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Sys Req 


This key allows the display to enter the system 
request state. See the index entry system request 
state. The key will not work when the display is in an 
error or SS state or when the controller is processing 
a Read, Write, Roll, Save, Restore, Write Error, or 
Copy command. See the index entry display, com- 
mands. Otherwise, the key is operational when the 
keyboard is in the locked or unlocked state. When 
Sys Req is used to exit a field, all field requirements 
must be met or an error occurs and Sys Req is 
ignored. See the index entry fie/ds for a description of 
the field restrictions. 


Using the Sys Req key results in the following 
actions: 


e Data on the error line is saved. 

e The error line is cleared. 

¢ Acolumn separator and an underscore field attri- 
bute are supplied for column 1 of the error line. 

e The cursor is located under column 2 and polling 
for keystrokes begins. 


When the LU is in the system request state, a 
message can be entered. When the operator presses 
the Enter/Rec Adv key, the controller sends the 
message to the host system on the SS-LU flow. No 
cursor address or aid codes are returned, embedded 
and leading nulls are converted to blanks, and 
trailing nulls are stripped. The resulting recovery 
depends on the state of the LU: 


e If the LU was in an LU-LU session, the previous 
contents of the error line are restored and the LU 
is returned to its pre-system request state. 


e lf the LU was in an SS-LU session, the message 
stays on the display but has normal attributes 
assigned. The LU returns to the pre-system 
request state. 


« Ifthe LU had not been activated, it is restored to 
its pre-system request state and an operator 
error of 004X, 005X, or 0099 is posted. For details, 
see the index entry operator error codes. 


Any replies sent on the SS-LU (FMD) session are 
posted on the error line. When the operator presses 
the Error Reset key, the previous contents of the 
error line are restored and the LU returns to its pre- 
system request state. 


MDT Bit 


There is a modified data tag (MDT) bit for each input 
field and there is a master MDT bit. These bits are 
used to determine which fields the controller should 
send to the host system in response to the Read MDT 
command. The host system programmer can set the 
MDT bit for a field and the master MDT bit by coding 
bit 4 of the field format word in the SF order of the 
Write to Display command; the operator sets the 
master MDT bit and the MDT bit for a field any time 
he keys data into or alters the field. Once the bits are 
set, only a control character for resetting it, a Clear 
Unit or Clear Format Table command, or an SOH 
order can reset them. For details, see these index 
entries field format word; display, commands; orders; 
and control characters, display. 


Modems 


There are basically two types of modems: synchro- 
nous and nonsynchronous. In a synchronous 
modem, the clocking signals are generated within the 
modem and sent to the controller for clocking pur- 
poses. In a nonsynchronous modem, a clock in the 
5251 Model 2 or 12 must supply the synchronization 
for signals to be sent to and from the host system. 
See the index entry clock. The 5294 does not support 
nonsynchronous modems. 
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Modes — SDLC 


This topic describes the SDLC/SNA modes that the 
controllers support; if you want information about the 
display station and printer modes, see States and 
Modes in this section. These are the available SDLC 
modes. 


¢ Normal response mode (NRM): For 5250 control- 
lers, this means that the work station/controller 
has entered an operational mode that will allow 
an informational interchange in response to 
receiving an SNRM. 


¢ Normal disconnect mode (NDM): For 5250 con- 
trollers, this means that the controller is in a dis- 
connected state that will not allow informational 
interchange (except XID or test information). 
SNRM, XID, DISC, TEST, and CFGR (CFGR not 
supported on the 5294) commands are accepted 
and acted upon. All other commands are 
responded to with DM. In this mode, nol or 
supervisory frames are allowed to be sent. See 
the index entries SDLC, commands and 
responses and frames. 


Multinational Character Set 


The Multinational Character Set displays a 
188-character set (184 of which are printable) and 
supports the hexadecimal usage and diacritic keys on 
all displays in the 5250 family except the 5291 Models 
1 and 2. 


The 5294 Control Unit supports the diacritic function 
for the multinational character set. The 5294 also sup- 
ports the diacritic function for the different languages 
if either the Display Write/36 Program Product feature 
or the Enhanced Keyboard Support feature is 
installed. 


The 5294 does not have the Multinational Character 
set in the U.S.A. base product. A feature is available 
for the U.S.A. that allows multinational devices to be 
used. 


Hexadecimal Usage of the Keyboard 


By entering hexadecimal codes on the keyboard, you 
can generate any EBCDIC character that is not avail- 
able on the keyboard but is needed for input and dis- 
playing within an input field. The hexadecimal usage 
of the keyboard is not allowed when the display 
station is in the insert mode. 


To enter a hexadecimal code for an EBCDIC char- 
acter, refer to Hex Key Function. 


Diacritic Keys 


Using a diacritic key allows you to place a diacritic 
(modifying) mark above a character to indicate a dif- 
ferent phonetic value for that character. 


Various diacritic keys are available. However, the 
only diacrictic you can enter above a character is one 
that appears on one of the diacritic keys on your key- 
board. The available diacritics are shown below: 
‘ (Grave Accent) 
’ (Acute Accent) 
~ (Tilde) 
A (Circumflex) 
(Diaeresis) 
(Cedilla) 


To enter a diacritic above a character, press the 
diacritic key and then the character. The 5251 Model 
2 or 12, 5294, or the host system then checks to see 
that the diacritic key and the character key pressed 
are a valid combination. Valid combinations for each 
diacritic are shown below: 


Diacritics: Allowable Characters: 
‘ (Grave Accent) AEIOU 
’ (Acute Accent) AEIOU 
~ (Tilde) ANO 
A (Circumflex) AEIOU 
(Diaeresis) AEIOU y(y is allowable only 
as a lower case character) 
4 (Cedilla) C 


After the diacritic and character combination has 
been checked and found to be correct, the cursor 
moves to the next position. If the combination is not 
valid, a 0029 error code is shown on the display 
screen. 
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Note: When the diacritic is keyed, the cursor will stay 
under the diacritic in anticipation of the combining 
character. If only a diacritic is desired, press the 
Spacebar on the typewriter-like keyboard or on the 
data entry keyboard, the Space key on the data entry 
keyboard with Proof Arrangement, or the — (Right 
Cursor Movement) key to advance the cursor to the 
next position. 


Using the Hexadecimal Code to Enter Diacritics or 
Accented Characters 


For the U.S.A. and multinational countries, the 
diacritics, their allowable characters, and corre- 
sponding hexadecimal codes are given in the fol- 
lowing chart. For non-multinational countries, refer 
to the charts in Figure 2-2 and Figure 2-3. Charac- 
ters that have a heavy line surrounding them will not 
print as shown but will print as specified by the Set 
Graphic Error Action control character or, if unspeci- 
fied, as a hyphen. 


Select the desired diacritic or the accented character 
from the chart. Its corresponding hexadecimal code 
can be found by: 


1. Following the column containing the diacritic or 
the accented character to the top of the chart. 
The character at the top of the chart is the first 
character of the hexadecimal code. 


2. Following the row containing the diacritic or the 
accented character to the left of the chart, the 
character at the left of the chart is the second 
character of the hexadecimal code. 
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Multinational Only 


First Hexadecimal Character 
Second 


Locate a Paes eae aed aE RES ET 


Character 
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Space 
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Negative Responses 


The state of the LU determines the sequence of 
actions that results from: (1) hardware failures or (2) 
data stream errors or contention. 


Hardware Errors 


If the LU is receiving RU chains from the host system 
and a hardware error occurs, the controller sends the 
host system a negative response followed by the 
Rshutd command and the Lustat command. 


lf the LU is sending RUs, or is not sending or not 
receiving RUs when a hardware error occurs, the 
controller sends an Rshutd and a Lustat command to 
the host system. See the index entry rshutd 
command. 


Data Stream or Contention Errors 


If the LU is receiving RU chains from the host system 
when a data stream error or contention error occurs, 
the controller issues a negative response to the host 
system. 


If the LU is sending RU chains when a data stream 
error or contention occurs, the controller sends a 
Cancel command followed by a Lustat (indicating the 
error has been sent to the host system). A Lustat is 
sent when a contention error is cleared. See the 
index entries cancel command and /ustat command 
for details. 


Contents of the Negative Response 


The negative response is an 8-bit code that has the 
following format: 


Major/Minor User User 
Code Byte 1 Byte 2 
XXXX yy ZZ 


The major/minor code is a standard SNA code that 
identifies the error class. User byte 1 identifies the 
failing component: 


for yy: 
00 = SNA data, SS-PU error, or cluster 
feature controller error 
01 = display 


02 = printer , y | 


User byte 2 identifies the specific error. The following 
chart gives detailed information about these contents. 


The negative responses that follow are generated by 
the controller and may differ from negative responses 
generated by the host system. 
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Description 


(All code is shown in hexadecimal.) 


0801 Ca Resource is not available. 


0811 02 ZZ ; 
00 Cancel from printer while 
not in error state. 
01 Cancel from printer while 
in error state. 


0813 Begin bracket indicator 
on in RQ. 


Bind received but LU 
already active. See the 
index entry bind 
command. 


Hardware error. 
Controller error. 


Invalid sense information. 
Cable overrun condition. 


Send hardware failure. 
Undefined hardware 
error. 

Display failure. 

No response. 

Transmit activity check. 
Receive parity check. 
send parity check. 
Receive length check. 


Wrong station response. 


Power on transition. 
Missing activate 
read/write response. 
Invalid command. 
Invalid register value. 
Storage or input queue 
overrun. 

Null/attribute exception 
check. 

Invalid activate. 
Undefined exception 
response. 

Invalid bit in poll 
response. 


Invalid outstanding status. 


Even/odd status 

time out. 

Busy time out or invalid 
busy. 


Description 


Printer hardware failure. 
No response. 

Transmit activity check. 
Receive parity check. 
Line parity check. 
Receive length check 
(wrong number of bytes, 
poll or read status). 
Wrong work station 
responded. 

Power-on transition (in 
session). 

Invalid command. 
Undefined exception 
Station (110). 

Input queue or storage 
overrun. 

Line parity error during 
active sequence should 
have been reported 
(0204). 

Invalid activate. 
Undefined exception 
status (011). 

Even/odd status time out. 
Hardware busy time out. 


0821 Invalid session parameters 
in Bind or Actlu command. 


0829 CD bit not sent with 
request that requires it: 
for example, CD not sent 
with a Save, Read Screen, 
or Read Immediate 
command. 


082D i The command is valid but 


has been rejected because 
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the display is in a mode 
that does not support the 
command. (For example, 
display error line is in use.) 
Chain processing ceases. 
Note: The host system 
should send a null RU 

with CD on if this -rsp is 
received on the LU-LU 
flow. The controller will 
send Lustat X00010000 
when the contention 
condition has cleared. 


1005 
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Description 


ZZ Actlu or Bind type not 

00 supported. See the index 
entries actlu command 
and bind command. 

01 Invalid data stream 
command. 

03 Copy to Printer feature not 


installed. 


Parameter error. All chain 
processing stops. 

Display data stream error. 
Invalid length value (LL 
or L) for structured field. 
Invalid class or type for 
structured field. 

Invalid parameter value in 
structured field. 

Invalid data stream 
command in WP mode. 
Invalid data stream 
command in DP mode. 
Command cannot be 
displayed with unlocked 
keyboard. 

Premature data stream 
termination. 

Invalid row and column 
parameters in SBA, IC, or 
RA order. See the index 
entry orders. 

The address in the RA 
order is less than the 
display address. See the 
index entry RA order. 
Invalid SF order field 
length. See the index 
entry SF order. 

Invalid SF order starting 
address. See the index 
entry SF order. 

Invalid data following 
Restore command. See 
the index entry restore 
screen command. 
Attempt to define a field 


Format table overflow. 
Attempt to write data 


Invalid SOH length. See 
the index entry SOH 
order. 


past the end of the display. 


past the end of the display. 


01 
(cont.) 


Description 


Parameter error in the 
Roll command. See the 
index entry roll 
command. 

Reserved. 

Reserved. 

Reserved. 

Invalid SF order screen 
attribute. See the index 
entry SF order. 

Printer in session. See 
the index entry copy to 
printer features. 

The LSID is not valid for 
the printer. See index 
entry copy to printer 
feature. 

Expanded Function 
feature not installed. 
Invalid self check length. 
See the index entry FCW 
Self check. 

Invalid self check FCW. 
See the index entry 
FCW, self check. 

Printer data stream error. 
See index entry printer, 
data stream. 

Invalid SNA SCS 
command. See the index 
entry Control! characters, 
printer. 

Invalid SNA SCS 
parameter. See the index 
entry contro! characters, 
printer. 

Invalid IPDS printer 
command. 

IPDS reset or read 
multiple status requested. 


2002 foo = foo. «S| Chaining error detected. _ Chaining error detected. _| error detected. 
2004 Request received while 

in send state. 
7 PP 


; Pf 
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The specified LSID is not 
assigned to an LU. See 
the index entry addresses. 


A request is issued to an 
LU that is not in session. 
See the index entries 
bind command and actlu 
command. 


Operator Error Codes 


The controller performs the following actions to post 
an operator error to the display: 


1. Locks the keyboard. 


2. Determines the error display line by using byte 5 
of the SOH order or defaults to the last line. See 
the index entry SOH order. 


3. Saves the contents of the error display line. 


4. Writes a screen attribute and a 4-digit error code 
to the error display line. The beginning screen 
attribute is a high-intensity blink and the trailing 
screen attribute is nondisplay. See the index 
entry screen attributes. 


5. Positions the cursor at the error and then blinks 
the cursor. 


6. Polls the locked keyboard looking for the oper- 
ator to press one of the following keys: 


e Attn: When this key is pressed, the controller 
sends the host system a Signal command. 
See the index entries signal command, 
command and response code. 


e Help: When this key is pressed, the con- 
troller: 


— Changes the leading screen attribute of 
the error message to a high-intensity no- 
blink. 

— Sends the Signal command, which 
includes the 2-byte error code. If the host 
system does not respond with a Write 
Error Code command and text, the key- 
board remains locked. See the index 
entries signal command, command and 
response code for details. 

— Waits for the operator to press the Error 
Reset key. If, instead, the operator 
presses Help again, the controller sends 
a Signal command containing bytes 2, 3, 
4, and 5 of the error message back to the 
host. 


e Error Reset: When this key is pressed, the 
controller: 


— Restores the contents of the area that 
had been saved, when the error code 
was written, back to the display. 

— Leaves the cursor at its current position. 

— Unlocks the keyboard and allows the 
operator to enter data. 


Note: All other keys except the shift keys, 
which are always valid, are ignored. 


The operator’s guide for each device contains a list of 
operator error codes and a description of the error. 
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Orders 


Five orders appear in the Write commands (FM 
LU-LU flow of the output data stream) for the display 
station LUs. (The output data stream is what the host 
system sends the LU via the controller in the SNA 
RU.) The orders specify the characteristics of the 
display. These orders are: 


e Insert Cursor (x’03’) 

e Repeat to Address (x’02’) 

e Set Buffer Address (x’11’) 

e Start of Field (x’1D’) 

e Start of Header (x’01’) 

The topic Display Data Stream Commands under the 
heading Commands in this section describes how the 


orders are coded within the output LU-LU commands. 
Figure 2-8 illustrates the sequence of the orders. 


SBA 
Row,Column 
Address 


Follow the arrows to determine the direction 
of the flow. A path such as this. 


ot ico (ee 


Indicates that the boxed order is optional. 


Figure 2-8. Orders 
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IC 
Row, Column 
Address 


RA and 
Parameter 


and 
Character 


The following description gives specified information 
about each order. 


Insert Cursor (IC) Order 


Function: This order (1) sets the system insert 
cursor (IC) address to the location specified by the 
two bytes that follow the order when it is included in 
the Write to Display command or (2) moves the 
cursor to the specified address without affecting the 
system IC address when it is included in Write Error 
Code command. Byte 1 gives the row address and 
byte 2 gives the column address. See the index 
entries home key and display, commands. 


Note: If there are more than one of these orders in 
the display station output data stream (LU-LU com- 
mands from host system to controller for LU), only 
the last one is saved. It is used as the home address 
(system IC address) for the Home function. 


Restrictions: A parameter error is posted when: 


e There are fewer than two bytes following the 
order. 


e The row address equals 0 or is greater than: 
— 24 for Model 12 (1920 characters) or 
— 12 for Model 2 (960 characters). 


e The column address equals 0 or is greater than 
80. 


Format: 


Insert Cursor Byte 1 Byte 2 
Order (Row (Column 
Hex 03 Address) Address) 
Hex 13 


Results: 


e When the order is used in the Write to Display 
command, the cursor is not immediately moved; 
the address is saved for later use. The cursor is 
moved when the entire WTD is completed. 


e When the order is used in the Write Error Code 
command, the cursor is moved to the address 
given inthe IC order and does not affect the 
system IC address. The cursor exits the field 
regardless of the type and does not perform any 
field checks. For example, it does not check for a 
filled field for a field specified as mandatory fill. 


Repeat to Address (RA) Order 


Function: This order displays a character in every 
position starting from the current display address and 
going to the last position specified by this order. If 
these two addresses match, 1 character is displayed. 


Format: 

Order Last Position Character 
Address (r,c) 

Hex 02 


3 bytes 


Restrictions: A parameter error is posted when 
there are fewer than 3 bytes after the order; when 
there is a row address value either equal to 0 or 
greater than 12 for Model 2 (960 characters) or 24 for 
Model 12 (1920 characters); or when there is a 
column address value greater than 80 or equal to 0. 
The order is also rejected if the specified ending 
address is less than the current display address. 


Note: Although any character can be repeated, avoid 
using hex 11 (SBA), because this value is used as the 
delimiter between the fields sent in response to the 
Read MDT command. 


Results: The character is repeated from the current 
display address through the ending display address 
specified. The current display address is then 
updated to the value of the last position +1. 


Set Buffer Address (SBA) Order 
Function: 


e Read: Used as a delimiter between fields that 
are sent back to the host system in response to 
the Read MDT command. See the index entry 
read MDT fields command. 


e Write: Used to set the current display address 
and thereby determine where the data display or 
field definition begins. Two bytes that follow this 
order tell the 5251 Models 2 or 12 this informa- 
tion. 
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Restrictions: A parameter error is posted when: 
e There are fewer than 2 bytes following the order. 


e The row address is equal to 0 or greater than 12 
for Model 2 (960 characters) or 24 for Model 12 
(1920 characters). 


e The column size is equal to 0 or greater than 80. 


Default: When the SBA is not specified in the Write 
to Display, the data starts at row 1, column 1 because 
this is where the Write to Display command initializes 
it. See the index entry write to display command. 


Format: 
Set Buffer Byte 1 Byte 2 
Address (Row (Column 
Order Address) Address) 
Hex 11 


Start of Field (SF) Order 


Function: This order defines input and output fields. 
If an input field is being defined, it also resets any 
pending aid byte and locks the keyboard. 


Note: Although this order can be used for output 
fields, it is not recommended because it degrades 
performance. Use the SBA order instead. 


Restrictions: A parameter error is posted when: 


e The output data stream ends before the given 
number of bytes have been sent. 


e The field length is equal to 0, if the field is not 
signed numeric. If the field is signed numeric, 
either aQ or a 1 Causes an error. 


Note: The length byte is ignored when an entry is 
modified in the format table. 


e The address for the end of the field exceeds the 
end of the display. 


e The input field addresses are not in ascending 
order. For input fields defined by previous Write 
to Display commands, the input field address 
must be equal to the starting address of an 
already specified field or greater than the last 
field already defined. 


e Too many input fields are defined for the display. 
e Invalid screen attribute is specified. 


e The defined input field overlays a previously 
defined field. 


Format: 
SF 2-Byte 2-Byte 1-Byte 2-Byte 
Order Field Field Screen Field 
Hex 1D Format Control Attribute Length 
Word Word (See Note.) 


(optional) (optional) 
1 or more 


Note: See the index entry screen attributes. Bits 0-2 
must be in the format B’001xxxxx’ or an invalid 
screen attribute error is posted. All other bits are 
described in the screen attributes text. 


Results: 


1. The display address is set to the end-of-field 
address (as specified by the last SF order) + 1. 
This does not happen if this is the first SF order 
or if an SBA order precedes it. The SBA will point 
to the field starting attribute. 


2. The screen attribute in the SF order is written in 
the location defined by the display address. 


3. The start-of-field address is set to the display 
address +1. 


4. The end-of-field address is set to the display 
address + the field length specified in the SF 
order. See Notes 1, 2, and 3. 
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5. The ending screen attribute (hex 20) is supplied 
by the controller and written at the end-of-field 
address + 1. See Notes 1, 2, and 3. 


6. The display address is incremented by 1. 


7. If this is an input field (one in which a field format 
word has been specified), a format table entry 
consisting of the field format and field control 
words is generated. In addition, if the SF order is 
rejected, the keyboard is locked and any out- 
standing aid byte is cleared. See Notes 1, 2, and 
3. 


e 


Notes: 


1. Format Table Modification: If the display address 
+ 1 is equal to the starting address of an input 
field that was previously defined, then: 


a. The field format word of the previously 
defined field is overlaid with the new field 
format word. The previous screen starting 
attribute is overlaid with the new screen 
starting attribute. 

b. All field control words and length parameters 
that were specified are ignored. Two bytes, 
however, are still required for the length 
parameter even though no value check is 
made against them. 

c. The field ending address is set equal to the 
field’s original ending address. 

d. Writing the screen ending attribute at the end 
of the field is suppressed. 


2. The defined field is not filled with nulls; if you 
require nulls in the field, use the Clear Unit 
command prior to issuing the Write to Display 
command. 


3. If the SF order is rejected due to an error condi- 
tion, the keyboard will be locked and the aid 
codes cleared; however, all other operations 
associated with the SF order will be suppressed 
and the format table will be intact. 


4. If data characters follow the length field, they will 
be written into the newly defined field. 


Start of Header (SOH) Order 


Function: This order specifies the header informa- 
tion that goes into the format table. See the index 
entry format table. It also selects the resequencing 
function when data is read from the display. See the 
index entry field control word. 


Restrictions: A parameter error is posted when the 
output data stream ends before the number of bytes 
needed have been sent or when the first byte of the 
order is not between 1 and 254. 


Format: 


Order Length 
Hex 01 (Note 1.) 


Variable Bytes 
(Note 2.) 


Notes: 

1. The length byte determines the number of header 
bytes following the length byte, but this number 
does not include the length byte. It must be 


greater than 0 and less than 255. 


2. This chart shows what the bytes following the 
length byte can contain: 


Byte Description 


1 Reserved 
2 Format ID - from hex 00 to hex FF 
3 Hex 00 = no resequencing (all rese- 


quencing field control words are ignored). 
Hex xx = resequence per field control 
words in format table. See the index entry 
field control word. (For example, xx = 01 
= field 1). Byte 3 also points to the first 
field to be returned when the Read Input 
Fields/Read MDT command is serviced. 

4 Row address of the operator error line. If 
this is unspecified or out of range, the 
error line defaults to the last line of the 
display, or to the message line, if sup- 
ported. 


Note: If a display were in 132 x 27 mode, 
selection of line 26 would result in line 26 
being used. If the same display were in 
80 x 24 mode, the message line would be 
selected. 
5-7 The following chart shows the data- 

included switches for the command func- 
tion keys. 
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P/F Bit Jo 


The P/F (poll/final) bit is a single bit that is in the 
control field of every SDLC frame type (Supervisory, 
Nonsequenced, and Information). When the host 
system sends an SDLC frame to the controller, the bit 
becomes the poll bit. When the poll bit is on, it indi- 
cates that the host system’s transmission of data is 
complete; it also demands an immediate response 
from the controller. When the controller sends an 
SDLC frame to the host system, the bit becomes the 
final bit. When the final bit is on, it indicates that the 
controller transmission of data is complete. 


Command Function Key 


Pacing 


Byte 9 of the Bind command (see the index entry bind 
command) contains a parameter that allows the user 
to determine the rate at which the receiver can 
accept data via the SNA data flow. This ability to 
control the rate of transmission of data is called 
pacing. The host system should use a pacing count 
of 0 (no pacing) when it transmits to the display 
station and a pacing count of 3 when it transmits to 


the printer. | j 


Note: If the host system wants to pace the display, its 
pacing value should be placed in byte 8 of the Bind 
Note: If the mask bit = 0, then the field data is request. 

returned via the Read MDT or Read Input Fields 

command when the command function key is 

pressed. If the mask bit = 1, only the cursor address 

and aid code are returned. Remember, if all three 

data-included bytes are not coded, the Cmd and 

command function keys will act as aid-generating 

keys and return the cursor address, aid code, and 

data in the input fields to the host system when they 

are used. 


Noon fh WM — © Nn fh WM — CO aman % 


-—- pO wth ODN © 
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Request/Response Header 


(RH) 


The RH consists of 3 bytes. These 3 bytes follow the 
TH and immediately precede the RU part of the SDLC 
frame. The following illustration shows the RH and a 


description of the fields. 


Byte O 
Request |R/C/C 
Header RIA|A 
(RRI=0) LiTIT] ryt yl 


Header 
(RRI=1) 
Field 


RRI Request Response 
Indicator 
CAT Request/ Response 
Unit Category 


Fl Format Indicator 

BCI Begin Chain 
Indicator 

ECI End Chain Indicator 

DR1 Definite Response 1 


DR2 Definite Response 2 


ERI Exception Response 
Indicator 


S|B/E|D) |DE 
F|D}C|C)/R| |R/R 


1ir{/2)l]rir 


Explanation 


O = Request (RQ) 

1 = Response (RSP) 

OO = FM data (FMD) 

01 = Network control (NC); invalid 
10 = Data flow control (DFC) 

11 = Session control (SC) 

0 = No SNA command follows 

1 = SNA command follows 


O = Not first in chain 00 = MIC 
1 = First in chain 01 =LIC 
O = Not last in chain 10 = FIC 
1 = Last in chain 11 = OIC 
O = Not DR1 

1=DRI1 

0 = Not DR2 

1 = DR2 


Used in conjunction with DR1, DR2 to 
indicate the form of RSP requested as follows: 


DR1,DR2,ERI = 000 No response 


= 001 Reserved 

= 100/010/110 Definite response 
(RQD1 /2) 

= 101/011/111 Exception response 
(RQEL1/2) 
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Explanation 


Response Type} 0 = Positive response 
Indicator 1 = Negative response 


Queued 0 = Bypass queue 
Response 1 = Use queues (QR) 


Indicator 


Pacing 0 = No pacing 
Indicator 1 = Pacing (PAC) 

BBI Begin Bracket | 0 = No BBI 
Indicator 1 = Begin bracket (BB) 


Data Indicator 


EBI End Bracket O = No EBI 
Indicator 1 = End bracket (EB) 
CDI Change = Do not change 
Direction direction 
Indicator 1 = Change direction (CD) 
CSI Code Selection| 0 = Code 0 
Indicator 1 = Code 1 (invalid) 
EDI Enciphered 0 = RU not enciphered 
1 = RU is enciphered 
(invalid) 
Padded Data 0 = RU is not padded 
Indicator 1 = RU is padded (invalid) 
The Format Indicator (Fl) designates the contents of 
the RU as Data, command, or Formatted Header 
(FMH). The 5294 does not support FM headers. 


Any time the Response Type Indicator (RRI) is equal 
to 1 (negative response), the Sense Data Included 
Indicator (SDI) will be equal to 1. Also a 4-byte sense 
data field will immediately follow the RH and be 
included as part of the RU. Any user data contained 
in the RU follows the sense data field. 


The Begin Chain indicator (BCI) and End Chain indi- 
cator (ECI) are encoded to represent the relative 
position of the associated RU within a chain as 
follows: 


> Fret AUn chan 6) 
> [ae RU in nan) 
ae Ru mena 0) 


RU (Request/Response Unit) 


The request/response unit (RU) contains all the com- 
mands and data sent between the host system and 
the controller. It is immediately preceded by the TH 
and RH. The RU, together with the TH and RH, form 
the path information unit (PIU). Each RU can be a 
maximum of 256 bytes long; however, FMD RUs may 
be chained together, if more than 256 bytes need to 
be sent, by marking the RUs relative to their position 
in a chain by bits in the RH. 


ESC Command Code 

Hex 04 and Associated 
data (See the index 
entry display, 
commands.) 


ESC More Cmds 


See also Protocols and Synchronization for 5250 
Implementation of SNA in Section 1. 


Screen Attributes 


Each screen attribute is eight bits long; the screen 
attributes reside in the regeneration buffers and 
control the characteristics of the display. They are 
coded in the SF order or may be embedded with 
other display data following the Write to Display 
command. See the index entries SF order and 
Display commands and the appropriate operator’s 
guide for your machine. Each bit of the screen has a 
specific reference to the display. These bits deter- 
mine how the information is going to be displayed. 


The bits representing screen attributes show as 
blanks on the normal display. The following chart 
describes the resulting display characteristics for 
each screen attribute bit pattern for the various dis- 
plays. 
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Hexadecimal 


Bit/Code Resulting Character Display 


ooeooor,ervaAraooooy,|s,mw 


- =} Oofr-'+-o00 + + OD 0 | ® 


Normal 

Reverse image 

High intensity’ 

High intensity '/reverse image 
Underscore 
Underscore/reverse image 
Underscore, high intensity’ 
Nondisplay 

Blink 

Blink, reverse image 

Blink, high intensity’ 

Blink, high intensity’, reverse 
image 

Blink, underscore 

Blink, underscore, reverse 
image 

Blink, underscore, high 
intensity ' 

Nondisplay 

Column separator 

Column separator, reverse 
image 

Column separator, high 
intensity’ 

Column separator, high 
intensity’, reverse image 
Column separator, underscore 
Column separator, 
underscore, reverse image 
Column separator, 
underscore, high intensity ' 
Nondisplay 

Column separator, blink 
Column separator, blink, 
reverse image 

Column separator, blink, high 
intensity! 

Column separator, blink, high 
intensity', reverse image 
Column separator, blink, 
underscore 

Column separator, blink, 
underscore, reverse image 
Column separator, blink, 
underscore, high intensity ' 
Nondisplay 


5251, 5252, 5291, 3180, and 3196 
3179 and 5292 (Limited Color) 5292 (Full Color), 3179 Models 2 or 220 


Green 

Green/reverse image 
White 

White/reverse image 
Green/underscore 
Green, underscore, reverse imag 
White, underscore 
Nondisplay 

Red 

Red, reverse image 

Red, blink 

Red, reverse image, blink 


Red, underscore 
Red, underscore, reverse image 


Red, underscore, blink 

Nondisplay 

Turquoise, column separator 

Turquoise, column separator, reverse 
image 

Yellow, column separator 

Yellow, column separator, reverse image 
Turquoise, underscore, column separators 
Turquoise, underscore, reverse image, 
column separators 

Yellow, underscore, column separators 
Nondisplay 

Pink 

Pink, reverse image 

Blue 

Blue, reverse image 

Pink, underscore 

Pink, underscore, reverse image 


Blue, underscore 


Nondisplay 


In limited color, high intensity will always be displayed as white on 5292 displays. 
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SDLC/Counter Error Codes 
(006X) 


The 006X error codes are for SDLC. They are placed 
in the error log when the controller counters that 
track SDLC transmission errors overflow or when the 
host system solicits the error log. The operator may 
display the counters that are formatted into these 
errors. See Problem Determination Procedures in 
the /BM 5251 Models 2 and 12 Operator's Guide, 
GA21-9323, or the 5294 Operator’s Guide, GA21-9370. 
See the index entries errors, error /og; errors, han- 
dling; and reqms command. 


The following chart describes each SDLC error code. 


0060 Bad test counter. 
Used with the SDLC Test command for 
diagnostic purposes. 


0061 Good test counter. 
Used with the SDLC Test command for 
diagnostic purposes. 


0062 Communications adapter underrun counter. 
0063 Communications adapter overrun counter. 
0064 Carrier detect glitch counter. 


Occurs when the carrier detect line is 
unexpectedly inactive. 


0065 Clear to send glitch counter. 
Occurs If the clear to send line is 
unexpectedly inactive. 


0066 Data set ready glitch counter. 
Occurs if the data set ready line is 


unexpectedly inactive. 


0067 Frame sequence error counter. 


Occurs when frame sequence errors occur. 


Occurs each time an Il frame must be 
retransmitted. 


0068 Transmit retry counter. ) 


0069 CRC errors in FCS field. 
Occurs each time the FCS character does not 
match the expected FCS character. 


006A Frame aborts received. 

O06B XLCA card detected errors. 

OO6E Number of | frames transmitted by the 5294 
(4 bytes). 

OO6F Number of | frames received by the 5294 
(4 bytes). 


SNA Chain End 


The last RU in a chain is indicated by turning on the 
Last in Chain indicator (bit 7) in byte 0 of the RH. 
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States and Modes 


The display station can be in one of several states 
(conditions) with their accompanying modes 
(methods of operation). A list of these states and 
modes follows: 


e Hardware error 
e Normal locked 
e Normal unlocked 
— Command mode 
— Insert mode 
— Data mode. 
e Power-on 
e Prehelp and posthelp error 
e SS message 
e System request. 


An explanation of each of the display station states 
and any accompanying modes follows. 


Hardware Error State 


The keyboard enters the hardware error state whena 
malfunction in the physical machine is detected. The 
characteristic of this state is that no keystrokes. are 
processed. When the error is cleared, the exit is to 
the normal unlocked state (format level 0 selected). 
See the index entry format level 0. 


Normal Locked State 


This state is entered either by the operator pressing 
a key that requires host system attention or by the 
host issuing a command that locks the keyboard. 
These are the valid commands the host system can 
use to bring the display station into this state: 


e Clear Unit 

e Clear Format Table 

« Write to Display (if the format table is altered) 

e Restore (if Save was issued to a locked key- 
board). 


The characteristics of the locked state are: 


e The keyboard is locked, the clicker is off, and the 
Input Inhibited indicator is on. 

e All keys except Sys Reg, Attn, Print (Cancel), and 
the Shift keys are ignored. 


The operator can exit this state by pressing the 
Sys/Req key. This places the display station in the 
system/request state. The user can exit this state by 
(1) issuing an unlock control character in a host 
command that will unlock the keyboard, (2) entering 
the SS message state, or (3) issuing an Actlu, Dactlu, 
Bind, or Unbind command. See the index entries 
control characters, display; SNA, commands; display, 
commands, and system request state. 


See Figure 2-11. 
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Normal Unlocked State 
The characteristics of this state are: 


e The keyboard is unlocked, the clicker is on, and 
the Input Inhibited indicator is off. 


e Invalid keys cause errors. 


The possible ways to enter the normal unlocked state 
are via: 


e Host commands that contain CC to unlock the 
keyboard. 


e The operator pressing the Error Reset after a 
keying error. 


e The operator performing one of the following 
reset operations when the original operation was 
initiated during a normal unlocked state: 

— Error reset following a Write Error command 
— Error reset following a Sys Req key activation 
— Error reset following an SS message 

— Error reset following a Cmd key activation. 


There are three modes that can be selected within 
the normal unlocked keyboard state. They are char- 
acterized in the following way: 


Command Mode 


(Command mode only exists on keyboards that have 
a Cmd key. It is not needed on other keyboards.) 


The operator selects this mode by pressing the Cmd 
key, which allows selection of preprogrammed 
command function keys. This mode cannot be 
entered when the keyboard is in the system request, 
normal locked, or error state, or in the insert mode. 
The operator can exit from this by pressing the Error 
Reset key or any of the top row function keys. 


Insert Mode 


The operator selects this mode by pressing the Ins 
key, which allows insertion of data or text into 
existing data or text. When the insert mode is in 
effect, the Insert indicator is on. This mode cannot be 
entered if the keyboard is in the normal locked, or 
error state, or in command mode. The exit is to the 
data mode when the operator presses the Error 
Reset key. 


Data Mode 


The operator selects this mode by keying, or the pro- 
grammer selects it with a CC. During this mode, the 
operator can preform any of the normal keying func- 
tions; the keyboard clicker is on, the Input Inhibited 
indicator is off, and the keyboard is unlocked. Exit to 
any of the other states is possible. 


see Figure 2-9. 


Posthelp Error State 
The operator enters the keyboard into this state by 
pressing the Help key after an error has occurred. 


The characteristics of this error state are: 


e The keyboard is locked, the clicker is off, and the 
Input Inhibited indicator is on. 


e Only the Attn and Shift keys are operational. 


e The leading attribute on the error line becomes 
high intensity. 


e Asignal is sent to the host system; see the index 
entry signal keys. 


See Figure 2-12. 


2-146 IBM 5250 Information Display System Functions Reference Manual 
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Power-On State 


This is the state that occurs between the time the 
controller receives electrical power and the time it 
enters another state such as the system request 
state. During this time, it is in a free keying mode. 
(Note that free keying cannot occur if the controller is 
powered down.) During this free keying mode, all 
functions that do not require the host system but that 
can be done under the control of the controller are 
allowed. The characteristics of this state are: 


e From row 1 and column 2 of the display to the 
end of the display is considered one alphanu- 
meric field. 


e The cursor movement and shift keys are func- 
tional. 


e Alphanumeric characters are accepted, trans- 
lated, and returned to the display. The cursor is 
updated to the next entry position. 


e Functions that the controller can handle are oper- 
ational. These are such functions as Del, Ins, 


Clear, and Display. 


e Function keys that require the host system cause 
errors when activated. 


See Figure 2-10. 


Prehelp Error State 

The prehelp error state is the first that the keyboard 
enters when the operator makes a keying error. The 
programmer can also enter this error state by coding 
the Write Error Code command. The characteristics 
of this error state are: 


e The keyboard is locked, the clicker is off, and the 
Input Inhibited indicator is on. 


e All keys except Attn, Help, Reset, and the Shift 
keys are ignored. 


e The error line is saved. 

e The error code is posted. 

e The cursor blinks. 

The operator can exit this state by pressing the Error 
Reset key; this returns the keyboard to its previous 
state. The operator can also choose to press the 


Help key and enter the posthelp error state. 


See Figure 2-11. 
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SS Message State 


The host system enters the keyboard into this state 
by using information contained in the host to con- 
troller SS-LU data flow. The characteristics of this 
state are that: 


e The keyboard is locked, the clicker is off, the 
Input Inhibited indicator is on. 


e Invalid keys are ignored. 
e The error line is saved. 


The operator exits this state by pressing the Error 
Reset key; the exit is to the previous state. 


See Figure 2-12. 


System Request State 


The operator initiates this state by pressing the 
Sys/Reqg key. The characteristic of the system request 
state is that the keyboard is unlocked. The error line 
is saved and filled with null characters. Use of 
invalid keys causes an exit to the error state. If the 
system request state was entered from the normal 
unlocked state by using the Sys Req key, the operator 
can reenter the normal unlocked state by pressing 
the Error Reset key; otherwise, input inhibited 
remains in effect. 


See Figure 2-10. 
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Alpha (shift) | Always valid. Always valid. Always valid. 
| |Alt (shift) Always valid. Always valid. Always valid. 
Invalid. Causes an error. |Always valid. Always valid. 


Invalid. Causes anerror. |Printer: Ignores the key Printer: Ignores the key unless it is 
unless it is receiving SNA receiving SNA chains.Then it issues 
chains. Then it issues a a -rsp to direct the user to 
-rsp to direct the user to stop sending chains. 
stop sending chains. 


Keyboard: Ignores the key |Keyboard: Ignores the key unless the 
unless the Copy to Printer Copy to Printer feature is installed and 
feature is installed and operating. Then it terminates the opera- 
operating. Then it term- tion without Causing an error. 

inates the operation without 

Causing an error 


| |Caps Lock |Always valid. Always valid. Always valid. 


— Not applicable. On the Valid if the cursor does Invalid if there is an attempt to leave a 
(Character |U.S.A. typewriter key- not leave the field. mandatory fill or self-check field without 
Backspace) | board, this is the Clear first satisfying the field requirements. 
and Test Request 
command function key. 


Always valid. Goes to For the 5251, 5252, 5291, Not applicable. The Cmd key exits from 
the normal locked state |and 5292, this key sequence |this mode. For the 5251, 5252, 5291, and 
and services any pending jis invalid because the Cmd_ 1/5292, this key sequence is invalid 
read commands by key is invalid inthis mode. |because the Cmd key is invalid in this 
returning the clear aid This key is always valid for |mode. This key is always valid for all 
code. If you are not in all other displays. Goes to |other displays. Goes to the normal locked 
session, the controller the normal locked state and |state and services any pending Read 
clears the screen and services any pending Read |commands by returning the clear aid 
format table. commands by returning the |code. If you are not in session, the 

clear aid code. If you are not|the controller clears the screen and 

in session, the controller format table. 

clears the screen and 

format table. 


Cmd Key or |Always valid. Invalid. Causes an error. Invalid if a mandatory fill or self-check 
Command/ field was being keyed without the 
Function operator satisfying the requirements of 
Keys the field. 


Figure 2-9 (Part 1 of 5). Effects of the Normal Unlocked State on the Display Station Keys/Functions 
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Key(s)/ 
Function(s) Command Mode Insert Mode Data Mode 


Command Invalid if there is an Not applicable. The Cmd |Not applicable. The Cmd key exits from 
Function Keys’ |attempt to leave a field key is invalid in this mode|this mode. 
1-24, (5251, without first satisfying the 
5252, 5291, mandatory fill, self-check, 
and 5292 only. jor right-adjust 

For other requirements of the field. 
displays, see It causes a mandatory 
Cmd Key or enter check if the master 
Command MDT bit is on. If it is 
Function Keys _ |valid, it goes to the locked 
on this chart.) state and services any 
pending Read commands. 


Valid if the cursor does 
not leave the field. 


|(Cursor Down) |Invalid. Causes an error. Invalid if an attempt is made to leave a 
mandatory fill or self-check field without 
the operator satisfying the field 


requirements. 


Valid if the cursor does 
not leave the field. 


«(Cursor Left) |Invalid. Causes an error. Invalid if an attempt is made to leave a 
mandatory fill or self-check field without 
the operator satisfying the field 


requirements. 


Valid if the cursor does 
not leave the field. 


— (Cursor Right) |Invalid. Causes an error. 


Data Keys 


Invalid if an attempt is made to leave a 
mandatory fill or self-check field without 
the operator satisfying the field 

requirements. 


Valid if the cursor does 
not leave the field. 


Invalid.Causes an error. Invalid if an attempt is made to leave a 
mandatory fill or self-check field without 
the operator satisfying the field 


requirements. 


Invalid. Causes anerror. |Validity depends onthe |Same as for insert mode. 
format table, cursor 
location, and data on the 


display. 


Invalid. Causes an error. |Always valid. Validity depends on the format table 
and cursor location. 


Display Mode Always valid. Not applicable. The Cmd |Not applicable. The Cmd key exits from 
(5251, 5252, key is invalid in this this mode. 
5291, 5292 only) 
Dup Invalid. Causes an error. |Invalid. Causes an error. |Validity depends on the format table 
and cursor location. 


mode. 
Figure 2-9 (Part 2 of 5). Effects of the Normal Unlocked State on the Display Station Keys/Functions 
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Key(s)/ 
Function(s) | Command Mode Insert Mode Data Mode 


Enter/Rec Invalid. Causes an error. |Invalid if there is an attempt |Invalid if there is an attempt to leave a 
Adv to leave a field without the |field without the operator satisfying the 
operator satisfying the mandatory fill, self-check, or 
mandatory fill, self-check, or|right-adjust requirements of the field. 
right adjust requirements of |Clears the insert mode. Causes a 
the field. Clears the insert |mandatory enter check if the master 
mode. Causes a mandatory |MDT bit is on. If valid, goes to the 
enter check if the master locked state, and services any pending 
MDT bit is on. If valid, goes | Read commands. 
to the locked state, and 
services any pending read 
commands. 


Erase Input |Invalid. Causes an error. |Invalid. Causes an error. Always valid. 
Always valid. Always valid. Always valid. 


Field+ Invalid. Causes an error. |Invalid. Causes an error. Validity depends on the format table, 
(typewriter- cursor location, and data on the display. 
like keyboard 

only) 


Field- Invalid. Causes an error. |Invalid. Causes an error. Validity depends on the format table, 
cursor location, and data on the display. 


Invalid. Causes an error. |Valid if the cursor does not |Invalid if there is an attempt to leave a 
leave the field. mandatory fill or self-check field without 
the operator satisfying the field 
requirements. 


Invalid. Causes an error. |Valid if the cursor does not |Invalid if there is an attempt to leave a 
(Field leave the field. mandatory fill or self-check field without 
Backspace) the operator satisfying the field 
requirements. 


Field Exit Invalid. Causes an error. |Invalid. Causes an error. Validity depends on the format table, 
cursor location, and data on the display. 


Invalid. Causes anerror. |Always valid. Goes to the Valid except in active right-adjust fields. 
normal locked state, and Goes to the normal locked state, and 
services any pending read_ |services any pending read commands. 
commands. Clears the insert 
mode. 


Figure 2-9 (Part 3 of 5). Effects of the Normal Unlocked State on the Display Station Keys/Functions 
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Key(s)/ 
Function(s) Command Mode Insert Mode Data Mode 


Home Invalid. Causes an error. |Invalid. Causes an error. |Invalid if an attempt is made to leave a 
mandatory fill or self-check field without 
the operator satisfying the field 
requirements. 


Invalid. Causes an error. |Always valid. Validity depends on the format table 
and cursor location. 


(New Invalid. Causes anerror. | Valid if the cursor does Invalid if an attempt is made to leave a 
not leave the field. mandatory fill or self-check field without 

the operator satisfying the field 

requirements. 


Num (Shift) Always valid. Always valid. Always valid. 


Invalid. Causes an error. |Invalid. Causes an error. |Invalid if an attempt is made to leave a 
mandatory fill, self-check, or active right- 
adjust field without the operator 
satisfying the field requirements. If 

valid, it goes to the locked state and 
services any pending read commands. 


Record Invalid. Causes anerror. |Invalid. Causes an error. |Valid any time except from an active 
Backspace right-adjust field. Goes to normal 
Function locked state and services any pending 
read commands. 


Roll] or Rollf |Invalid. Causes an error. |Invalid. Causes an error. 
(Roll Down) 


or (Roll Up) 


Invalid if an attempt is made to leave a 
mandatory fill, self-check, or active 
right-adjust field without the operator 
satisfying the field requirements. If 
valid, it goes to the locked state and 
services any pending read commands. If 
the master MDT bit is on, it causes a 
mandatory enter check. 


Figure 2-9 (Part 4 of 5). Effects of the Normal Unlocked State on the Display Station Keys/Functions 
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Key(s)/ 
Function(s) Command Mode Insert Mode Data Mode 


tPage Up or Invalid. Causes an error. |Invalid. Causes an error. |Invalid if an attempt is made to leave a 
Page Down mandatory fill, self-check, or active 
right-adjust field without the operator 
satisfying the field requirements. If 
valid, it goes to the locked state and 
services any pending read commands. lf 
the master MDT bit is on, it causes a 
mandatory enter check. 


Always valid. Always valid. Always valid. 
Always valid. Always valid. Always valid. 


Invalid. Causes anerror. |Invalid. Causes an error. |Invalid if an attempt is made to leave a 
mandatory fill or self-check field without 
the operator satisfying the field 
requirements. Flushed when the 
controller is processing data received 
from the host system. 


For the 5251, 5252, and 5292, not 
applicable because the Cmd key exits this 
mode. For all other displays, the key is 
valid and the display goes to the normal 
locked state. 


{3 (Shift Lock) 
(typewriter- 
like keyboard 
only) 


(} (Shift Up) 
(typewriter- 
like keyboard 


Always valid. Goes to the |Invalid. Causes an error. 
normal locked state. 


Figure 2-9 (Part 5 of 5). Effects of the Normal Unlocked State on the Display Station Keys/Functions 
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Alpha (Shift) Always valid. Always valid. 

Invalid. Causes an error. Invalid. Causes an error. 

Flushed. Ignored. Same as for normal 
unlocked state. 
Always valid. 
Always valid. 
For 5251, 5252, 5291, and 5292, this 
key sequence is invalid because 
the Cmd key is invalid in this mode. 
For all other displays, the Clear 


Caps Lock Always valid. 
« (Character Backspace) Always valid. 
Always valid. 


Command Function Keys 1-24 
| (Cursor Down) 

<- (Cursor Left) 

— (Cursor Right) 

7 (Cursor Up) 

Data Keys 

Del 

Display mode 


Dup 

Enter/Rec Adv 

Erase Input 

Error Reset 

Field+ (Typewriter-like keyboard 


— | (Field Advance) 
| — (Field Backspace) 
Field Exit 


a (New Line) 

Num (Shift) 

Page Down 

Page Up 

Print 

Record Backspace Function 

Roll | (Roll Down) 

Roll 7 (Roll Up) 

QO (Shift Lock)(Typewriter-like 
keyboard only) 

Cy (Shift Up)(Typewriter-like 
keyboard only) 

Sys Req 


Test Req (Test) 


Always valid. 
Invalid. Causes an error. 
Always valid. 
Always valid. 
Always valid. 
Always valid. 
Always valid. 
Always valid. 
Always valid. 


Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Always valid. 
Always valid. 


Invalid. Causes an error. 
Always valid. 
Always valid. 
Always valid. 
Invalid. Causes an error. 
Always valid. 
Always valid. 
Always valid. 
Always valid. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Always valid. 


Always valid. 


Always valid. Goes to system 


request state. 
Invalid. Causes an error. 


key is always valid. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Always valid. 

Always valid. 

Always valid. 

Always valid. 

Always valid. 

Always valid. 


Not applicable. The Cmd key is 


invalid. 

Invalid. Causes an error. 
Always valid. 

Always valid. 

Always valid. 

Always valid. 


Invalid. Causes an error. 
Always valid. 
Always valid. 
Always valid. 
Invalid. Causes an error. 
Always valid. 
Always valid. 
Always valid. 
Always valid. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Invalid. Causes an error. 
Always valid. 


Always valid. 
Ignored. 


Invalid. Causes an error. 


Figure 2-10. Effects of the Power-On and System Request States on the Display Station Keys/Functions 
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Key(s)/Function(s) 


Alpha (Shift) 


Always valid 
Always valid. 
Always valid. 
Always valid. 
Ignored. 

Ignored. 


Ignored. 
Ignored. 

Ignored. 

Ignored. 

Ignored. 

Ignored. 

Ignored. 

Not applicable. The Cmd key is 
invalid. 

Ignored. 

Ignored. 

Ignored. 

Ignored. 

Ignored. 


Command Function Keys 1-24 
|(Cursor Down) 

«(Cursor Left) 

— (Cursor Right) 

t(Cursor Up) 
Data Keys 
Del 

Display Mode 


Dup 

Enter/Rec Adv 

Erase Input 

Error Reset 

Field+ (Typewriter-like keyboard 


Ignored. 
Ignored. 


(Field Advance) 


| — Ignored. 
(Field Backspace) 
Field Exit Ignored. 


Ignored. 
Ignored. 
Ignored. 
Ignored. 


(New Line) 
Num (Shift) 

Print 

Record Backspace Function 
Roll? or Page Down 

(Roll Up) 

U} (Shift Lock) 
(typewriter-like keyboard only) 
( (Shift Up) 

(typewriter-like keyboard only) 
Sys Req 


Always valid. 
Ignored. 
Ignored. 
Ignored. 


Always valid. 


Always valid. 


Flushed otherwise. 
Ignored. 


Test Req (Test) 


Valid when the display station is not 
processing data from the host system. 


Always valid. 
Always valid. 
Always valid. 
Ignored. 
Ignored. 
Ignored. 


Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 


invalid. 
Ignored. 
Ignored. 
Ignored. 
Always valid. 
Ignored. 


ignored. 
Ignored. 


Ignored. 


Ignored. 
Always valid. 
Ignored. 
Ignored. 
Ignored. 


Always valid. 
Ignored. 
Ignored. 
Ignored. 
Always valid. 


Always valid. 


Ignored. 


Ignored. 


Figure 2-11. Effects of the Normal Locked and Prehelp Error States on the Display Station Keys/Functions 
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Not applicable. The Cmd key is 


Normal Locked State Prehelp Error State 
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Key(s)/Function(s) Posthelp Error State SS Message State 


Alpha (Shift) 
Attn 
Cancel 
«(Character Backspace) 
Clear 
Cmd 
Command Function Keys 1-24 
| (Cursor Down) 
< (Cursor Left) 
— (Cursor Right) 


7 (Cursor Up) 
Data Keys 
Del 

Display Mode 


Dup 

Enter/Rec Adv 

Erase Input 

Error Reset 

Field+ (Typewriter-like keyboard 


Always valid. 
Always valid. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 

Not applicable. The Cmd key is 
invalid. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 


Ignored. 


Always valid. 
Always valid. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 

Not applicable. The Cmd key is 
invalid. 
Ignored. 
Ignored. 
Ignored. 
Always valid. 
Ignored. 


Ignored. 


Figure 2-12 (Part 1 of 2). Effects of the Posthelp Error and SS Message States on the Display Station Keys/Functions 
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Key(s)/Function(s) 


>| 


(Field Advance) 


| 


(Field Backspace) 
Field Exit 


«! (New Line) 


Ignored. 
Ignored. 


Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 


Ignored. 
Ignored. 


Ignored. 
Ignored. 
Ignored. 
Ignored. 
Ignored. 


Posthelp Error State SS Message State 


Num (Shift) Always valid. Always valid. 


Print Ignored. Ignored. 
Record Backspace Function Ignored. Ignored. 
Roll) (Page Up) Ignored. Ignored. 
(Roll Down) 

Roll? (Page Down) Ignored. Ignored. 

Roll Up) 

U (Shift Lock) Always valid. Always valid. 
(typewriter-like keyboard only) 

“ ‘Shift Up) Always valid. Always valid. 
(typewriter-like keyboard only) 

Sys Req Ignored. Ignored. 

Test Req (Test) Ignored. Ignored. 


Figure 2-12 (Part 2 of 2). Effects of the Posthelp Error and SS Message States on the Display Station Keys/Functions 
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Figure 2-13 illustrates the errors that result from using invalid keys. 


Data Mode Errors 


Mandatory Right-Adjust Mandatory Fill Check Digit 
Enter Field Field Field Field Insert Mode Errors 


Command Function 0013 (Note 1) 


0013 (Note 3) 
0013 (Note 1) 


0013 (Note 1) 


Erase Input 


Home 0014 
(Note 2) 


Print 0014 


Help (non-error) 


Notes: 

1. See Figure 2-9. 

2. The error occurs only if the home position is not in the field. The insert mode is automatically reset. 

3. A 0013 occurs when the operator presses the Cmd key on a 5251, 5252, 5291, or 5292. All other displays 

execute the Clear function. 

Legend: 

OO-- The operator error code is displayed if the display is in insert mode, or if the field specified is mandatory 
enter, right-adjust, mandatory fill, or check digit and the function specified is not satisfactorily fulfilled. 
The function is valid and is performed. 
Not applicable. 


Figure 2-13. Errors that Occur When Invalid Keys are Used in Data and Insert Modes 
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TH (Transmission Header) 


The TH is a control field used by path control in SNA. 
The TH is 2 bytes long and follows the FAC in the 
SDLC frame. The following illustration shows the 
fields in the TH and also contains a brief description 
of each field. 


Byte 0 0 1 


Bits 0123456701234567 


Field Explanation 


FID Format Identification 0000 = FIDO (invalid) 
0001 = FID1 (invalid) 


0010 = FID2 (invalid) 
0011 = FID3 
MPF Mapping Field 00 = Middle segment 
(invalid) 
(Segmenting) 01 = Last segment 
(invalid) 
10 = First segment 
(invalid) 
11 = Only segment 
EFl Expedited Flow 0 = Normal flow 
1 = Expedited flow 
Y SS/LU Indicator 0=SS 
1 = LU 
Z PU/LU Indicator 0 = PU 
1 = LU 
LSID local Session 00000000 = SS/PU 
session 
Identification O1xxxxxx = SS/LU 
session 


10xxxxxx = Reserved 
11xxxxxx = LU/LU 
session 
XXXXXX = 0 to 63 local 
address 
r Reserved Set to 0 


The expedited flow indicator is set to 1 when expe- 
dited commands are sent. 


The LSID is used to identify each logical session that 
exists between the 5294 and the host system. 
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Expanded Cluster Feature 


This feature is an optional feature for users who 
require more work station capacity. The Expanded 
Cluster feature adds two twinaxial connectors (ports 
1 and 2) to the 5294 to support up to eight work 
stations (six with X.25 support). 


1200 bps Integrated Modem 


The 1200 bps Integrated Modem is an internal 
modem that provides a means of communication 
between a 5251 Model 2 or Model 12 and a host 
system over switched or nonswitched communi- 
cations lines. It requires the Internal Clock feature to 
generate a clocking pulse to synchronize its signals 
for transmitting and receiving. 


The 5294 does not support the 1200 bps Integrated 
Modem. 


2400 or 4800 bps Integrated 
Modem 


The 2400 or 4800 bps Integrated Modem is an internal 
modem that provides communications between the 
5251 Model 2 or Model 12 and a host system over 
switched or nonswitched communications lines. 


When either of these modems is used, the Internal 
Clock feature must not be installed on the 5251 Model 
2 or Model 12. The 2400 or 4800 bps Integrated 
Modems generate the clocking pulse needed to syn- 
chronize the signals for transmitting and receiving 
signals. 


The 5294 does not support the 2400 or 4800 bps Inte- 
grated Modem. 


X.25 Feature 


The X.25 feature is required to connect the 5294 
Control Unit to the X.25 Packet Switching Network. 
This feature provides the HDLC protocol for X.25 
communications. When the X.25 feature is selected, 
either the EIA/CCITT Interface adapter for X.21 bis 
Support or the XLCA Adapter for an X.21 nonswitched 
line must be specified. Packet sizes of 64, 128, or 256 
bytes are supported. 


The host system converts SNA/SDLC information into 
a packet form that the network can handle. The X.25 
feature provides a similar function in the 5294 Control 
Unit. Line speeds between the X.25 feature and the 
network may be as high as 48,000 bps in duplex 
mode. A switched virtual circuit (SVC) or a perma- 
nent virtual circuit (PVC) can be used. 


Packet switching data network facilities that can be 
optionally specified are: 


e Reversed charging 

e Closed user group 

e Flow control negotiation of both packet window 
size and packet size 

e Throughput class negotiation 

e Recognized private operating agency (RPOA) 
selection. 


The X.25 feature also allows the use of facilities not 
specified by CCITT Recommendation X.25 (1980); for 
example, priority class of service. 


X.25 operations differ from other communications 
networks as follows: 


¢ The SDLC communications protocol is not avail- 
able. 

e ADDS adapter may not be used. 

e The test request option link test can only be initi- 
ated from the host. 

e Some operator error codes are changed or 
added. 

e Communications codes are added; a complete 
list is given in this manual. 

e The error log includes X.25 information. 


Other operations, such as the following, remain the 
same: 


e Controller and work station addressing proce- 
dures are identical. 

e SNA session control and data flow remain the 
same. 

e SNA commands are unchanged. 
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X.25 Feature Functions 


The functions of the CCITT Recommendation X.25 
(1980) supported by the 5294 are: 


¢ Packet Layer 
— Packet size (specifically the user data field) 
can be 64, 128, 256 bytes. 
— Window size can be 2-7 packets. 
— Packet sequence numbering is modulo 8. 


e Link layer 

— Link access protocol, balanced mode (LAPB) 
is the data link protocol. Link access pro- 
tocol (LAP) is not Supported. 

— SABM and DISC commands are always sent 
with the P bit on. 

— RR and RNR commands are always sent with 
the P bit on. 

— The maximum number of bits in a frame 
(excluding flags, the frame check sequence, 
and 0 bits inserted for transparency) is 2,088 
(259 bytes). 

— The maximum number of transmissions and 
retransmissions of a frame after a T1 time out 
is ten. 


e Physical layer 
— CCITT Recommendation X.21 is followed. 
— X.21 bis ts allowed. 
— %X.21 nonswitched is allowed. 


Some functions are not supported by the 5294: 


e Packet layer 

— Interrupt packets and datagrams are not 
used, and if received, are treated as errors. 

— Reject packets are not supported. 

— The fast select facility is not supported. 

— The bilateral closed user group facility is not 
supported. 

— Receive not ready (RNR) packets are not 
transmitted. An RNR packet arriving at the 
5294 suspends packet transmission until a 
receive ready (RR) packet arrives. 


Five time outs are used by the 5294: 


If the clear-to-send signal on the network DCE 
drops, a 30-second delay is allowed for error 
recovery. 

T1 time out is fixed at 3.0 seconds. 

Call request (T21) time out is about 200 seconds. 
Reset request (T22) time out is about 200 
seconds. 

Clear request (T23) time out is about 200 
seconds. 


Additional requirements for the 5294 are: 


In an incoming call packet, byte 0 of the call user 
data field must contain hex C2 (PSH), C3 (QLLCT) 
or C6 (ELLC). The 5294 defaults to the protocol 
indicated in the incoming call packet. 

In an incoming call packet, the maximum size of 
the facilities field is 63 bytes. 


Frame Level Performance Characteristics 


When one frame has completed transmission 
successfully, the 5294 preempts other processing 
to initiate transmission of a new frame as soon as 
possible. 


Piggybacking avoids the transmission of unnec- 
essary overhead packets and frames by having 
the information carried with data flowing in the 
opposite direction. The 5294 performs packet- 
level piggybacking. 
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SNA/X.25 Relationship 


Figure 2-14 shows how the SNA layers already pro- 
vided in the 5294 relate to the X.25 layers provided by 
the X.25 feature. Function management data (FMD) 
services, the highest SNA layer, are followed by data 
flow control, transmission control, and path control. 
The lowest SNA layer, data link control, is replaced 
by a logical link control layer and three layers 
defined by X.25: the packet layer, the link layer, and 


the physical layer. 


Communications Layers 


FMD 
Services 


Data Flow 


Layers 
Defined Control 
By o2ua 
SNA Transmission 
Control 
Path 
Control 


Defined by Logical Logical Link 


Link Control Control 
Layers 
by 
X.25 


Physical 


To the 
Public Data 
Network 


5294 Components 


Basic 
Hardware 
and 
Micro- 
Program 


Feature 
Hardware 
and 
Micro- 
Program 


Basic 5294 
Hardware 


Figure 2-14. Relationship between SNA and X.25 Levels with the X.25 Feature 
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The X.25 packet and link layers provide another form 
of data link control. The third X.25 layer, the physical 
layer, provides functions that are used by SNA layers 
but are not specifically defined as a separate layer. 
The physical layer conforms to CCITT Recommen- 
dations X.21 bis and X.21 (nonswitched). 


When the 5294 establishes connection to the packet- 
switching data network, the lower layers are acti- 
vated first. That is, the physical layer is activated 
first, then the link layer, then the packet layer, and so 
on. 


Establishing and Closing an SVC/PVC 
Connection 


The sequence for establishing an SVC/PVC con- 
nection between the 5294 and the host is defined 
below. Figure 2-15 shows these steps and indicates 
the parts of the network involved with each step. 


1. The controller obtains the parameters for the 
connection from either operator input or cus- 
tomer setup. 


2. Thecontroller activates the physical layer and 
the link layer, and the link layer issues the link 
access procedure, balanced mode (LAPB) 
command, SAB\M, to establish the data link to the 
network node. A 15-second delay is provided 
between operator input and link activation. 


3. The controller activates the packet layer by 
issuing a restart request packet. After packet 
level activation, a call request packet is sent for 
an outgoing request or the controller waits for an 
incoming call packet for an incoming request. 
This step is not required for PVC connections, 
because the virtual circuit is permanently estab- 
lished. 


4. After the host has established an SNA connection 
with the 5294, the controller builds SNA com- 
mands and data into packets, and sends them to 
the host via the X.25 network. 


5. When the data reaches the controller, the data is 
in the form of SNA path information units (PIUs). 
The controller builds the PIUs into packets and 
sends the packets to the host inside LAPB frames 
via the X.25 network. 


The connection is closed down in reverse order using 
four steps: 


1. Following the issuing of the Vary Off command at 
the host, SNA commands and the SNA session. 


2. Fora PVC, the virtual circuit remains active and 
another SNA session can be started by a Vary On 
command at the host. For an SVC, the NIA or host 
sends a clear request packet to the network. The 
network in turn sends a clear indication packet to 
the 5294 to clear the SVC. 


3. Thecontroller displays a communications code 
on the operator’s screen (SVC only). 


4. OnanSVC, the operator may begin a new con- 
nection procedure to an alternate (or the same) 
host. 


Formats of Communications Components 


The relationship between the three major compo- 
nents involved in the communications process 
between the 5294 and the host is shown in 

Figure 2-16. The SNA path information unit (PIU), 
developed by the SNA handling portion of the 5294 is 
built into one or more packets by the controller, 
depending on the size of the PIU and packet size. 
Each packet is, in turn, built into an LAPB frame and 
then sent to the network. 
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Step 1: Obtaining connection parameters 


X.25 
Feature 


Step 2: Establishing the link to the network 


Feature 


Step 3: Establishing the virtual circuit 


X.25 
Feature 


Step 4: Establishing the SNA connection 


Packets Packets 


X.25 
Feature 


Step 5: Data transfer 


Data SNA X25 Packets Packets 
SNA Network > 
Feature 
PIU 


Figure 2-15. Establishing the Connection between the 5294 Control Unit and the Host 
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Packets Packets 


Network <> 


Network <a> 


SNA 


Device Commands 


a 
oe an, 
Remote Controller 
a 
\ / 
ye ri 
N / 
- Legend: 
LLC Logical Link Control 
-QLLC O bytes 
X.25 Network -ELLC 6 bytes 
-PSH 2 bytes 
PH Packet header 3 bytes 
F Flag 8 bits 
A Station address 8 bits 
C Control field 8 bits 
| Information field variable 
TH ~ Transmission header 2 bytes 
RH Request/responseheader 3 bytes 
RU  Request/response unit 0-256 bytes 
) FCS Frame check sequence 16 bits 
Figure 2-16. The PIU/Packet/Frame Relationship 


F Flag 8 bits 
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LAPB Frames and Commands 
LAPB frames consist of: 


e <A leading flag 

e An address field 

e Acontrol field containing a command or 
response 

e An information field (I-frames only) 

e A frame check sequence 

e A trailing flag. 


LAPB commands and responses supported by the 
X.25 feature are: 


Packets 


The information field of the LAPB information frame 
contains a packet. The packet consists of as many as 
three fields: 


« A packet header containing, for example, the 
general format indicator, the logical channel 
number, and the packet type identifier 


e A logical link control header, if the packet is a 
data packet 


e Auser data field containing the PIU developed by 
the SNA logic. 


Packet types that are used or supported by the 
feature are: 


Call Request 
Incoming Call 

Call Accepted 

Call Connected 
Restart Request 
Restart Indication 
Restart Confirmation 
Clear Request 

Clear Indication 
Clear Confirmation 
Reset Request 
Reset Indication 
Reset Confirmation 
Data 

Receive Ready (RR) 
Receive Not Ready (RNR) 
Diagnostic. 


Logical Link Control (LLC) 


There are three types of LLC that can be used on the 
5294. They are: 


e QLLC: Q bit logical link control 
e ELLC: Enhanced logical link control 
e PSH: Physical services header. 


These protocols serve to make an X.25 virtual circuit 
appear as an SDLC link to the highest levels of SNA. 
The type of LLC is determined at customer setup 
time. 


The formats for each type of LLC are described in the 
following topics. 
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Q Logical Link Control (QLLC) 


QLLC is a type of logical link control available on the 
5294. The selection of the type of LLC is determined 


by: 


Customer setup 

Operator input of call parameters 
Incoming call packet (SVC) 

First data packet (PVC). 


QLLC commands and responses are transmitted ina 
normal data packet with the qualifier bit (Q bit) set to 
1. 


QLLC Data Packet Format 


Byte 0-2 3,4 4,5 


5,6 
Packet Address Control Information 
Header Field Field Field 
Byte 0, 1,2 - See Packet header format 
Byte 3,4 - QLLC address field 


Byte 4,5 - QLLC control field 
Byte 5,6 - QLLC information field (if allowed) 


e QLLC Address Field 
— Qbtained from customer setup data for QLLC 


data packets transmitted 
— Ignored on QLLC data packets received. 


QLLC Control Field 


e The 5294 will respond to any nonsupported com- 
mands by issuing a clear request packet (for 
SVC) or a reset request packet (for SVC) or a 
reset request packet (for PVC) with the diagnostic 
code = X’50’ (QLLC error). 


The QLLC commands and responses are described in 
the following paragraphs. 


QSM 


This is a mode-setting command equivalent to a 
normal secondary station receiving a SNRM 
command, which may have been initiated by a Vary 
On command at the remote host. 


The 5294 initiates a NRM-entered TCB to SNA whena 
QSM is received. 


QDISC 


This is a mode-setting command equivalent to a 
normal secondary station receiving a DISC 
command, which may have been initiated by a Vary 
Off command at the remote host. 


The 5294 initiates a DISC command TCB to SNA when 
a QDISC is received. 


QxXID 


This is a XID command equivalent to a normal 
primary station sending a XID command, which may 
have been initiated by a Vary On command at the 
remote host. 


The QXID response returned has the same data 
content as the 5294. 


QTEST 


The QLLC command/response pair performs the 
same function as the 5294 test command/response. 


QUA 


This is a mode-setting response equivalent to a 
normal secondary station transmitting a UA response 
to a SNRM command. 


QDM 

This is a QLLC response indicating that normal data 
packets have been received prior to receiving a QSM 
command. 

¢ QLLC information field 


— Test Data: Same as transmitted by host 
— XID Data: Same as transmitted by the 5294. 
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Enhanced Logical Link Control (ELLC) 


Recovery from temporary network outages is pos- 
sible using ELLC. When a network generated reset, 
restart, or clear (with nonzero cause code) is 
received by the 5294, the packet level responds with 
the appropriate confirmation packet and initiates 
ELLC recovery. 


Upon timer expiration, if the circuit is SVC, a recon- 
nection process is attempted. If the 5294 initiated the 
original call, a new call request is generated and the 
connection ID in the call request indicates that this is 
a reconnect. 


If the 5294 answered the original call, the circuit state 
is ready and the incoming call must indicate in the 
connection ID that this is a reconnected call. 

In either case, if the connection ID does not indicate a 
reconnect, the recovery attempt is terminated with a 
clear request and a diagnostic code of X’5B’. 

ELLC commands and responses are transmitted ina 
normal data packet with six ELLC header bytes as the 
first six data bytes, as shown below. 


Logical Protocol Data Unit (LPDU) Format 


Byte 0-3 4,5 6,/ 8,9 10 through n 


Check Sum Information 
Packet Header |Address Field |Control Field Field Field 


Byte 0-3: See Packet Header Format in this chapter (not part of the LPDU). 
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LPDU Commands and Responses 


Protocol 
Data Unit 


LRNR 
LREJ' 


a aa a 
p fevest ferests |i ft [1 fo ojo fs [1 Jofo fo fo ojo joj 


‘Transmitted by the 5294 Control Unit. 


The 5294 responds to any invalid PDUs by issuing a clear request packet (for SVC) or a 
reset request packet (for PVC). 


Unsolicited F bits (received when the 5204 is not in checkpoint recovery state) are 
ignored. Those PDUs are processed as if the final bit was not on. 


Nonsupported responses (LUA, LXID, LTEST) are ignored. 
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LSABME 


This is a Mode-Setting command equivalent to a 
normal secondary station receiving a SNRM 
command, which may have been initiated by a 
Vary-On command at the remote host. 


Receipt of this command is a requirement for the 
ELLC level of the 5294 to enter the data transfer state 
and exchange I- and S-PDUs with the adjacent logical 
link node. 


The 5294 sends an LUA response. The LNr and LNs 
counts are reset to zero and all unacknowledged 
IPDUs are purged. 


LSABME is never sent by the 5294. 

LDISC 

This is a Mode-Setting command that causes the 5294 
to leave the data transfer state and enter the logically 


disconnected state. 


The 5294 sends an LUA response. All acknowledged 
IPDUs are purged. 


If LDISC is received while the 5294 is in the logically 
disconnected state, a_LDM response is sent. 


A reset/clear is not issued to the virtual circuit. 
LDISC is never sent by the 5294. 

LXID 

This is a XID command equivalent to a normal 
primary station sending a XID command that may 
have been initiated by a Vary On command at the 
remote host. 

The LXID response returned by the 5294 has the 
same data content as the base 5294. This response is 


sent whether the 5294 is in data transfer state or not. 


LX!ID commands are never sent by the 5294. 


LTEST 


This ELLC command/response pair performs the 
same function as the base 5294 test 
command/response. 


Any test data received in the information field is 
returned in the LTEST response. This response is 
sent whether the 5294 is in the data transfer state or 
not. 


LTEST commands are never sent by the 5294. 
LDM 


The LDM is sent in response to any I- or S- com- 
mands, with the poll bit on, when the 5294 has not 
first been placed in the data transfer state by the 
receipt of aLSABME command. 


LDM is the response to LDISC, received when the 
5294 is in the logically disconnected state. 


LDM responses received causes the 5294 to reset 
and clear the virtual circuit. 


LUA 
This is a mode-setting response equivalent toa 


normal secondary station transmitting a UA response 
to a SNRM or DISC command. 


The 5294 responds with LUA to a LSABME command 
ifthe P bit is on. If the P bit is off, a reset/clear is 
initiated. 

lf an LUA response is received, it is ignored. 


LPDUR 


Upon receipt of LPDUR the 5294 resets and clears the 
virtual circuit. 


LPDUR is never sent by the 5294. 
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LI 


This is the informational command PDU used to 
transfer SNA PIUs. It is never sent with P=1orasa 
response by the 5294. 


When LI is received error free, it is processed and 
passed to SNA. 


If L! is received with P = 1, the 5294 responds with 
LRR (F = 1). 


Each LI PDU transmitted from the 5294 contains an 
LNR count, which acknowledges all IDPUs received 
and processed at that time. Since the receive and 
transmit functions are interleaved, each IPDU trans- 
mitted could carry an LNR count, which acknowl- 
edges IPDUs received since the previous LNR count 
was transmitted. 


LRR 


The LRR is equivalent to the receive ready frame at 
the link level. As a response, it is used to acknowl- 
edge IPDUs received. As a command, it is used to 
request acknowledgment of the number of IPDUs 
received. LRR also clears any previously established 
busy condition. 


When LRR is received as a command with P = 1, the 
5294 responds with LRR (F = 1). 


When LRR is received as an expected checkpoint 

response (F = 1), the 5294 frees all acknowledged 
IPDUs from the retransmit queue, and retransmits 
any unacknowledged IPDUs. 


The 5294 puts an LRR response in the transmit 
queue, as outlined under L7T2 Timer in this section. 
When this response works its way to the top of the 
transmit queue, a decision is made whether to send it 
or not. !f the LNr count to be sent is the same as the 
last LNr sent (no new IPDUs to be acknowledged), it 
is not sent. 


The 5294 sends an LRR command with P = 1 when 
its LT1 timer expires, and enters checkpoint recovery 
state. No other IPDUs are sent until the LRR response 
with F = 1 is received. 


LRNR 


The LRNR is equivalent to the receive not ready 
frame at the link level. As a response, it is used to 
acknowledge IPDUs received. As a command it is 
used to request acknowledgment of the IPDUs 
received. The LRNR also indicates the inability to 
receive IPDUs. This busy condition is cleared when 
the 5294 receives a LRR, LREJ, or LSABME. 


When LRNR is received as a command with P = 1, 
the 5294 responds with LRR (F = 1). 


When LRNR is received as an expected checkpoint 
response (F = 1), the 5294 frees all acknowledged 
IPDUs from the retransmit queue, but does not 
transmit/retransmit any IPDUs until the remote DTE 
indicates the busy condition has cleared. 


LRNR is never sent by the 5294. 
LREJ 


LREJ is equivalent to the reject frame at the link 
level. 


Receipt of LREJ clears any previously established 
busy condition. 


When LRE\V is received as a command with P = 1, 
the 5294 responds with LRR (F = 1), frees all 
acknowledged IPDUs from the retransmit queue, and 
retransmits any unacknowledged IPDUs. 


When LREJ is received as an expected checkpoint 
response (F = 1), the 5294 frees all acknowledged 
IPDUs from the retransmit queue, and retransmits 
any unacknowledged IPDUs. 


IPDUs received out of sequence (wrong LNs count) 
cause the 5294 to respond with LREJ. This estab- 
lishes a reject exception condition within the 5294, 
which is cleared upon receipt of the IPDU being 
requested by the LNr count in the LREJ. Only one 
reject exception condition is established at a time. 


LREJ with F = 1 is the response to a rejected IPDU 
received with P = 1. 


LREJ commands are never sent by the 5294. 


Section 2. Encyclopedia 2-171 


LT1 Timer 


The LT1 timer value is derived from operator input at 
call time and can range from 10 to 99 seconds. A 
default value of 10 is used if no operator input is 
processed. The LT1 timer provides a time-out func- 
tion to protect against a lost reply deadlock condition. 


The LT1 timer is started when an IPDU is transmitted 
or retransmitted and the LT1 timer is not already 
running. The LT1 timer is stopped when a response 
is received, acknowledging all outstanding IPDUs that 
have been transmitted or retransmitted. The LT1 
timer is restarted upon receipt of a partial acknowl- 
edgment. 


Upon expiration of the LT1 timer, an LRR command 
(P = 1) is transmitted to request status from the other 
end, and LT1 is restarted. At this time, checkpoint 
recovery state is entered and no IPDUs are sent until 
the requested response is received. If the LT1 timer 
stops during checkpoint recovery state, the LRR 
command is resent and the LT1 timer is restarted. 
Upon the tenth expiration of the LT1 timer (LN2 
reached) a reset/clear is issued to the virtual circuit. 


LN2 Counter 


The LN2 counter is used to control the number of suc- 
cessive LT1 time outs that can occur before the 
reset/clear is issued to the virtual circuit. The LN2 
counter is set to zero initially and incremented each 
time LT1 expires. When the LN2 counter reaches 10, 
the reset/clear is issued. This value cannot be 
changed by the user. 


LT2 Timer 


This timer is implemented to delay the LRR response 
to an IPDU and thus reduce traffic on the virtual 
circuit. The value is one-fourth the value of LT1. 


If the number of received but not acknowledged 
IPDUs exceeds a threshold of three before LT2 has 
reached a time out, an acknowledgment (LRR 
response) is put in the queue for transmission. 


PSH Logical Link Control 


PSH commands are carried only in data packets. 
Figure 2-17 shows the general format of the PSH and 
the format for physical services commands and 
responses. 
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J 


General Format 
Bit- 
First byte 


Second byte Sequence Num., Control or Data 


Format for PSDISC Command and Response 


Bit- O 1 2 3 4 5 6 7 
First byte 


Second byte 


First byte 


Second byte 


Format for PSTEST Command 
Bit- O 1 2 3 4 5 6 7 
First byte 


Second byte 


Format for PSTEST Response 
Bit- O 1 2 3 4 5 6 7 
First byte 


Second byte 


Third byte 


Local Station Address 


Figure 2-17 (Part 1 of 2). 


6) 1 2 3. 4 5 6 7 
ttt itt fo] si}rsi} cer 


SI - Segment Indicator 
PSI - Packet Sequence 
Indicator 
CPI - Control Present 
Indicator 


No Data Follows 


X|D Data Follows 


Test Data Follows 


Test Data Follows 


Format of the Physical Services Header 
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Format for PSCONT Command 


First byte 
Second byte 


Bit- O 1 2 3 4 5 6 7 


No Data Follows 


Format for PSCONT Response 


First byte 
Second byte 
Third byte 


First byte 
Second byte 


First byte 


No Data Follows 


Data Follows 


Data Follows 


Second byte Sequence Number 


Figure 2-17 (Part 2 of 2). Format of the Physical Services Header 
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As shown in Figure 2-17, the PSH is two bytes long. 
The first byte contains three indicator bits: 


e Segment indicator 
— When SI = 0, the data packet contains the 
last or only segment. 
— When SI = 1, the data packet contains the 


first or a middle segment of segmented data. 


e Packet sequence indicator (PSI) 
— When PSI = 0, the second byte of the PSH 
contains either control information or data 
(as defined by the control present indicator). 
— When PSI = 1, the second byte of the PSH 
contains a data packet sequence number. 


e Control present indicator (CPI) 

— When CPI = 0, the second byte of the PSH 
contains data or a sequence number as 
defined by the PSI bit. 

— When CPI = 1, the second byte of the PSH 
contains control information. 


Data Development with the X.25 Feature 


The development of data as it is transported through 
the SNA and X.25 layers is shown in Figure 2-18. 


Data emerges from the SNA data flow control layer 
as a request/response unit (RU). In the transmission 
control layer, a request/response header (RH) is 
added and in the path control layer a transmission 
header (TH) is added. The combination of TH, RH, 
and RU becomes a path information unit (PIU). 


The PIU is sent to the X.25 feature where LLC 


headers are added, then sent to the X.25 packet layer 
where a packet header (PH) and a logical link header 


(LLC) are added to the PIU to form a data packet. In 
the link layer, the packet becomes the information 
field in an LAPB frame. 


The format of the data packet is shown in Figure 2-18 
The packet header is three bytes long and contains 
the following fields: 


A general format identifier 
General format identifier in byte 0, bits 0-3: 


BitO 1 2 3 
QD C1iC2 


The PSH or ELLC protocol requires that the qual- 
ifier (Q) bit be set to zero. The delivery confirma- 
tion (D) bit is not used by the controller and must 
be set to zero. C1 and C2 bits indicate the 
modulus of the packet Sequence count: 


C1C2 = 01 modulo 8 


A logical channel identifier byte 0 bits 4-7 and 
byte 1. This indicates the logical channel (as 
seen by the controller) is being used. 


Packet-received P(R) and packet-send P(S) 
sequence numbers are used for acknowledging 
received data packets and for sequence checking 
of data packets. 


A more-data (M) bit. The PSH protocol does not 
use the M bit in the packet header. QLLC and 
ELLC protocols use the M bit for segmenting. The 
M bit is used to indicate middle segments in seg- 
mented data as described by CCITT Recommen- 
dation X.25. 


A bit that identifies the packet as a data packet. 
Byte 2, bit 7 = 0 for a data packet. 


Following the packet header (PH) is: 


The user data field that contains the LLC header 
(QLLC and ELLC only) 


All or part of a PIU depending on the size of the 
PIU and the packet size used. 


SNA commands such as ACTLU and BIND are trans- 
ported in the request/response unit (RU) of the PIU, 
which is treated as data by the controller. 
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SNA Data SNA SNA X.25 X.25 
Flow Trans. Path Packet 
Control Control Control Level 


FMD 
Services 


PACKET SWITCHING 


Physical DATA NETWORK 


Level 


Data Packet 


General Format | Logical Channel 


Identifier Group 
PH 
Logical Channel 
See Logical Link 
Control Formats _ User 
Data 
Field 


LLC Logical Link Control FCS Frame Check Sequence 

RU Request Unit PIU Path Information Unit 

RH Request/ Response Header S| Segment Indicator 

TH Transmission Header PSI Packet Sequence Indicator 

PH Packet Header CPI Control Present Indicator 

F Flag P(R) Packet-Received Sequence Number 
A Address P(S) Packet-Sent Sequence Number 

C Command M More-Data Mask 


Note that the LLC is part of the User Data Packet. 


Figure 2-18. Data Development with the X.25 Feature 


2-176 IBM 5250 Information Display System Functions Reference Manual 


Examples of Signal Exchange During 
Connection 


Figure 2-19 and Figure 2-20 show the exchanges of 
signals involved in establishing a connection 
between a host and the 5294 with the X.25 feature. 
Figure 2-19 applies when the 5294 starts the call and 
Figure 2-20 applies when the host starts the call. 
These illustrations show how SNA commands, LAPB 
commands, and packets work together. 


In Figure 2-19, the host starts link operations by 
issuing an LAPB Set Asynchronous Balanced Mode 
(SABM) command. The network replies with a posi- 
tive acknowledgment in the form of an unnumbered 
acknowledgment (UA) response. 


With a similar procedure, the 5294 initializes its link 
to the network by sending an SABM command and 
obtaining a UA response. 


In this example, the initiative to call belongs to the 
5294. The host operator enters a Vary-On command 
and waits for the 5294 to call. The 5294 signals the 
network to restore the connection to the 5294 to an 
initial state by sending a restart request packet. All 
packets are sent in LAPB information frames. A 
restart confirmation packet acknowledges that the 
network has initialized the connection. 


If the connection is a switched virtual circuit (SVC), 
the call is started when the 5294 sends a call request 
packet. This packet contains information about the 
facilities required for the call, possibly the address of 
the caller (5294), the address of the called (the host), 
and the logical channel to be used. This information 
is obtained from the display station operator through 
keyboard input. 


If the request is acceptable, the network sends an 

incoming call packet to notify the host about a call 
from the 5294. If the request is not acceptable, the 
network clears the 5294 call with a clear indication 
packet. 


Again, if the call is acceptable, the host sends a call 
accepted packet to the network. On receiving the call 
accepted packet, the network confirms that the virtual 
circuit is established by sending a call connected 
packet to the 5294. If the call is not acceptable to the 
host, it is rejected when the host sends a clear 
request packet to the network, which then sends a 
clear indication packet to the 5294. 


If the connection is a permanent virtual circuit (PVC), 
the connection is pre-established and the call request 
sequence just described is not needed. 


With the connection complete, and the 5294 varied 
on, the host issues an SDLC XID command. When this 
occurs, the host builds a data packet with the Q bit 
On, containing a QXID command. The data packet is 
sent through the network to the controller, which 
builds a reply and sends it within a data packet con- 
taining a QXID response. 


In Figure 2-19, the host tries to contact the other end 
of the connection by sending a QSM command to the 
5294. Again the host builds a data packet; in this case 
the Q bit is on and the command is QSM. When the 
5294 receives this data packet, it replies with a data 
packet that contains a QUA response. 


At this point, the host knows that a connection to the 
5294 exists and that the 5294 has been contacted. The 
host may now activate the logical unit in the 5294 by 
sending an SNA ACTLU command. This command is 
a PIU sent to the host X.25 feature, which builds a 
data packet around the PIU and sends it across the 
network to the 5294. The 5294 strips off the data 
packet and sends the PIU to the SNA handling portion 
of the 5294. 


Normal SNA operations continue, with each SNA 
command and response being a whole or partial PIU 
that is transported across the network inside a data 
packet. 


Figure 2-20 shows a similar sequence except that, in 
this case, the host starts the call. 
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Figure 2-21 shows an example of a connection close- 
down sequence. This starts when the host operator 
issues a Vary-Off command. An SNA Unbind 
command is received by the X.25 feature at the host 
and is built into a data packet, and is sent across the 
network to the 5294. 


The controller removes the Unbind command from 
the data packet and sends it to the SNA handling 
portion of the 5294. The controller then builds a data 
packet for the response from the SNA handling 
portion of the 5294 and sends it to the host. 


An identical exchange sequence occurs for the SNA 
DACTLU command, issued by the host to deactivate 
the LU in the 5294. 


The host can retrieve the contents of the statistical 
counters maintained by the 5294 by sending an SNA 
REQMS command to the X.25 feature at the host, 
which sends the contents inside a data packet to the 
5294. The 5294 sends the error log, as well as the 
contents of the statistical counters if the log ts not 
full, to the host with an SNA RECFMS response. This 
information is built into a data packet and sent to the 
host. 


When the host issues the QDISC command, a data 
packet with the Q bit on containing the QDISC 
command. For a PVC, the virtual circuit remains 
active and another SNA session can be started by a 
Vary-On command at the host. For an SVC, the host 
sends a clear request packet to the network. The 
network in turn sends a clear indication packet to the 
5294 to clear the SVC. 
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HOST X.25 Network 5294 
C Initialize Link Feature X.25 SNA-Handling 


Portion of the 5294 
SABM 
UA 

varyon Start Call 
5294 

(host configuration for Stele ek 

call-in operation) Initialize Link 
SABM 


COMM LINE SYNC 


UA 
Restart 
ad Request 


Packet 
Restart 
Confirmation — 
Packet 
Call 
2 Request 
Incoming Packet 
Call Packet 


Call SVC Only 
Accepted — 
Packet 

Call Connected a 

Packet 


XID -—-——-Te 

Data Packet 
Data Packet 
<«—,—— XID 


SNRM —— — 
Data Packet 


Data Packet 
VA +— =s 


—_——T ™ ACTLU 


Data Packet 


_—-—-- > 
Normal SNA Sequence Continues ACTLU 


— — —— SNA commands 


-—_> Packsts 


————_ _LAPB commands 


Note: For simplicity, RR packets and frames are not shown. 


Figure 2-19. Establishing a connection - 5294 starts the call 
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Note: For simplicity, RR packets and frames are not shown. 
Figure 2-20. Establishing a connection - Host starts the call 
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HOST X.25 Network 5294 
Feature X.25 SNA-Handling 
Vary Off 5294 Portion of the 5294 
UNBIND ——v7 > 


UNBIND — —|— ~~ 
<- —|— — response 
+ response 


< — -— — Response 
DACTLU ——7,+ 
peta Packet [_ pact 
<- — —— response 
+ response Data Packet 


REQMS — — > 
Data Packet 
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Data Packet 


—* —;— — RECFMS 
DISC 
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Packet 
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Clear Confirmation 


Confirmation Packet 


Packet 
DISC 


UA 


————» SNA commands 


— patkete 


————» LAPB commands 


Note: For simplicity, RR packets and frames are not shown. 


Figure 2-21. Closing Down a Connection 
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Errors and Problem Determination 


The error handling process used with the X.25 feature 
is built upon the normal 5250 error handling 
described in this manual under Error Handling. Most 
5250 error codes are unchanged, but some codes 
have been revised. In addition, the controller uses 
the error log and maintains soft error and status sta- 
tistics that can be retrieved by the host. 


Complete problem determination procedures are 
contained in the 5294 Operator’s Guide. 


Error Code Types 
As in the 5250, there are three types of errors: 


e Operator errors 
e Programming errors 
e Hardware errors. 


The X.25 feature does not change the programming 
error codes but because of additional operator proce- 
dures and additional hardware there are some 
changes to operator error codes and hardware error 
codes. 


Programming 
Error Codes 


Operator 
Error Codes 


Format 


01XX O2XX OOXX 1OXXXX 


Lustat or Negative 
Response Sent to Host 


Operator 
Keying Errors 
(unchanged) 
(see also 
hardware 
error codes) 


Parameter 


Input Errors 


As shown in Figure 2-22, most of the operator error 
codes are unchanged. An added group of operator 
error codes indicates errors that can occur when 
network parameters are entered by the display 
station operator. These errors have the format 
10xxxx. 


The hardware error codes shown in Figure 2-22 are 
those that are new or have been changed because of 
the X.25 feature. In particular, 004x, 005x, and 006x 
codes have new assignments. A new class of hard- 
ware error codes called communications codes is 
divided into two groups: 


© 11xxxx, 12xxxx, 1Axxxx, and 1Bxxxx codes for 
controller detected errors and messages 


¢ 18ccdd and 19ccdd codes for network detected 
errors. 


Figure 2-23 shows how the controller handles these 
new groups of hardware errors. 


Hardware Error Codes 


O06X 004X 
005X 
Soft Controller 5294 Network 
Errors Errors Detected Detected 
Errors Errors 
1100XX 18ccdd 
1200XX 19ccdd 
1A00XX 
1BOOXX 


Note: cc is a cause code; cause codes are supplied by the network. dd is 
a diagnostic code; diagnostic codes are supplied by the network, host, 


and controller. 


Figure 2-22. Error Code Types 


2-182 IBM 5250 Information Display System Functions Reference Manual 


5294 Detects an Error Network Host 


X.25 
Feature 


Clear Request Packet (SVC) Diagnostic = 
Reset Request Packet (PVC) Code=XX 


Network Detects an Error Network Host 


Clear Indication Packet (SVC) 

Reset Indication Packet (PVC) 

Diagnostic Packet 

Restart Indication Packet 

Cause code provided by the network = cc. 
Diagnostic code provided by the network = dd. 


X.25 
Feature 


Figure 2-23. Hardware Error Actions 
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When the controller detects an error, it sends a clear 
request packet (for a switched virtual circuit) ora 
reset request packet (for a permanent virtual circuit) 
through the network to the host. The packet contains 
a diagnostic code indicating that the X.25 feature has 
detected anerror. The diagnostic code is identical to 
the last 2 digits of the code that is displayed on the 
operator’s screen: 1100xx, 1200xx. 


When the host detects an error in the communi- 
cations with the 5294, it sends a clear indication 
packet (SVC) or a reset indication packet (PVC) to the 
controller, with a diagnostic code to identify the 
problem. The display station operator’s screen dis- 
plays an error code of 1800xx or 1900xx, where xx is 
the diagnostic code that the controller received from 
the host. 


When the network detects an error, the controller 
receives one of the following packets, depending on 
the particular network, the type of error, and the type 
of virtual circuit: 


e Clear indication packet (SVC) 
e Reset indication packet (PVC) 
e Diagnostic packet 

e Restart indication packet. 


The packet contains a cause code and a diagnostic 
code issued by the network. The display station oper- 
ator’s screen shows an error code with the following 
format: 


xxccdd xx00dd 
xxccdd 
xxccdd 


cc = Cause code 
dd = Diagnostic code 
xx = Type of packet 


xx = 18 reset indication packet 
xx = 19 clear indication packet 
xx = 1A restart indication packet 
xx = 1B diagnostic packet 


Note: On networks that do not propagate the host 
diagnostic code, the 5294 displays dd = 00. 


Note: For a diagnostic packet received, cc = A5 and 
dd indicate the diagnostic code passed in the diag- 
nostic packet. 


SDLC Counter Error Codes (X.25 Only) 


The 006X error codes are for SDLC. They are placed 
in the error log when the controller counters that 
track SDLC transmission errors overflow or when the 
host system solicits the error log. The operator may 
display the counters that are formatted into these 
errors. See Problem Determination Procedures in 
the /BM 5251 Display Station Models 2 and 12 Opera- 
tor’s Guide, GA21-9323, or the 5294 Operator’s Guide, 
GA21-9370. See index entries errors, error log; 
errors, handling; and reqms command. 
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C The following chart describes each SDLC error code. 006A Frame aborts received. 


0060 #£Bad test counter. 006B $=XLCA card-detected errors. 
Used with the SDLC Test command for 
diagnostic purposes. 006C Number of T1 time outs for X.25. 
0061 Good test counter. 006D Number of ELLC recovery attempts. 
Used with the SDLC Test command for 
diagnostic purposes. 00O6E Number of | frames transmitted by the 5294 
(4 bytes). 
0062 Communications adapter underrun 
counter. O0O6F Number of | frames received by the 5294 (4 
bytes). 


0063 Communications adapter overrun counter. 
Keyboard-Entered Options Error Codes 
0064 #£Carrier detect glitch counter. (X.25 Only) 
Occurs when the carrier detect line is 


unexpectedly inactive. If the 5294 Control Unit has the X.25 feature attach- 


ment and an error occurs during the keyboard 
entry of commands, options, or parameters, a 
6-digit error code of the form 10xxxx (where xxxx 
represents 4 hexadecimal digits) is displayed. The 
codes are summarized in the following chart. 


0065 # Clear to send glitch counter. 
Occurs if the clear-to-send line is 
unexpectedly inactive. 


0066 #£Data set ready glitch counter. 
Occurs if the data set ready line is 
\ unexpectedly inactive. 


0067 Frame sequence error counter. 
Occurs when frame sequence errors occur. 


0068 #£=Transmit retry counter. 
Occurs each time an | frame must be 
retransmitted. 


0069 CRC errors in FCS field. 


Occurs each time the FCS character does 
not match the expected FCS character. 
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Error Code 


A call command is still in progress. 


The host has not varied on the 5294 and a second command was attempted. 

An answer command was entered for a permanent virtual circuit. 

A call command was entered for a permanent virtual circuit (PVC). 

The TO address (first network address) is invalid because it is greater than 15 decimal digits. 

100800 The FROM address (second network address) is invalid because it is greater than 15 decimal 
digits. 


100900 The network address is invalid because it does not contain all numeric digits (O through 9). 


—s 
~) 
=) 
> 
ro) 
ro) 


Keyboard entry of optional parameters has been attempted, but the manual options (field 5, 
position 4 of the configuration setup) is 0 (off). 


A flow-control negotiation facility code (42 or 43) was entered, but the flow-control negotiation 


(field 5, position 3 of the configuration setup) is 0 (off). 


100B00 A facility was entered but the characters were not hexadecimal (0 through 9, and A through F). 


100C00 The window size requested is invalid because it is less than two. 


101500 A password was entered for a PVC. 
101600 The password entered is not valid because it is not alphanumeric. 


A logical channel identifier was entered for an answer. 

101900 The E option was selected with the answer option. 

101A00 
The logical link control value requested is invalid because it is not a decimal value. 


An F (facilities) control character or an R was entered for an answer command or a PVC. 
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Network Communications Error Codes (X.25 
Only) 


If the 5294 Control Unit accepts the keyboard entries 
but the network operation with the host system fails, 
one of the following codes, indicating the type of 
communications problem, is shown on the attached 
work stations. 


The data termination equipment (DTE) 
issued a clear request packet after 
detecting an error. The cause of the 
error is contained in the diagnostic 
field (ff). 


eves packet pe torsos 
15 [vata pete ypeter sana 
[so [oeneraticeror 
es 
a 
a 


54 Undefined I-field. 
55 I-field too long. 


a Frame reject received. 
(57 [Header invatia 


= 
(cont) 

SS eas SS 
cA 
; 
ee [inate etreqveses 
eo [vate protcoigertter 
eisai eng 


O 
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The data termination equipment (DTE) 
issued a reset request packet after 
detecting an error. 


ee 
si [undeines cts 
a 
eg 
se fundeinesiseie 
es 
Ts 
aa 
Ts 
= 


Frame reject received. 
Header invalid. 
Data received in wrong state. 


Time-out (LT1xLN2) condition. 


LNr invalid. 


Packet too short. 


A6 
oo creral resources 


The data circuit-terminating equipment 
(DCE) issued a clear indication packet 
after detecting an error. The cause 
codes (cc bytes) listed below are issued 
by the network and may vary from 
network to network. 


The cause codes listed here are defined 
by the CCITT Recommendation X.25. 


Ce 
ee 
es 
[oe _Jouretorer Hos nrensy 
[05 _[Accessioinerestnt alowed 
00 [onesnzeas een as 


Recognized private operating agency 
(RPOA) out of order. 


19 Reverse charging not subscribed. 
ai | Incompatible destination. 
p29 Fast selection not subscribed. 
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Error Code |Meaning 


The diagnostic codes (dd bytes) shown 
below are issued by the network and 
may vary from network to network. The 
codes listed here are defined by the 
CCITT Recommendation X.25. 


es 
: 
z 
: 
: 
; 
: 
: 
z 
E 
E 
E 
x 
x 
: 


virtual circuit. 
z 
z 
: 
2 
z 


29 Restart with nonzero in bits 1 through 4 
and 9 through 16. 


Meaning 
30 
: 


Peo fine esses 
[22 [rimer exper lear indication 
[20 [timer expired for rexeindcaion. 


Call setup problem 
Facility code not allowed. 


Call clearing problem 


[ae | Facility parameter not allowed 
eae Nonzero address length field. 


Invalid called address. 
Invalid calling address. 


Nonzero facility length field 
Network specific diagnostic information. 
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The data circuit-terminating equipment 
(DCE) issued a reset indication packet 
after detecting an error. The following 
Cause codes (cc bytes) are issued by 
the network and may vary from network 
to network. These codes are defined 
by CCITT Recommendation X.25. 


x 
oe [rence TE operators 


Error Code |Meaning 


The diagnostic codes (dd bytes) listed 
below are issued by the network and 
may vary from network to network. 
These codes are defined by the CCITT 
Recommendation X.25. 


00 Ne-esational formation 
I 


Meaning 
(cont) 


and 9 through 16 

: 
; 
41 


Facility code not allowed. 


Invalid packet type on a permanent 
virtual circuit. 


Invalid general format identifier. 


1C 
1D 
20 
21 

22 
23 
24 
25 
26 
27 

28 
29 
2A 
2B 
2C 


m 
=] 
bene | 
oO 
=| 
2] 
a. 
@o 


& 


2 Facility parameter not allowed. 


aN 
oo 


AS 


Invalid called address. 


Invalid calling address. 


on 


0 Call clearing problem. 


ol 
—_ 


Nonzero address length field. 


5 Nonzero facility length field. 


2 
80-FF Network specific diagnostic information. 
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The data termination equipment (DTE) 1BA5yy The definition of the yy bytes is 
issued a reset request packet after described in the X.25 Interface for 
detecting an error. The cause codes (xx Attaching IBM SNA Nodes to 
bytes) are listed below. Packet-Switched Data Networks, 


Diagnostic packet received. See note. 
Packet length less than two. 


Invalid GF (restart 
indication/confirmation only). 


General Information Manual, 
GA27-3345. 


LCID not equal to 0 on restart 

31 Call connected not received within 200 
seconds 

32 Clear confirmation not received within 
200 seconds. 

33 Reset confirmation not received within 
200 seconds. 

34 Restart confirmation not received 
within 200 seconds 


Note: The diagnostic packet received has 2 
additional descriptive bytes. The 5294 appends the 
first of these in the yy position indicated. 


Unsolicited restart confirmation 
received. 
indication/confirmation. 
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X.21 Switched Circuit Feature 


The X.21 Switched Circuit feature for the 5294 Control 
Unit enables the 5294 to be connected to X.21 Public 
Data Networks that provide circuit switched services. 


Supported Functions 

The X.21 call establishment protocol, the call 
progress protocol, the call clearing protocol, and the 
necessary International Alphabet No. 5 support are 
added to the 5294 to implement the X.21 automatic 
answer and calling functions. With the X.21 Switched 
Circuit feature and the X.21 adapter, the 5294 can 
operate at speeds of 2400 to 48,000 bps. 

Other X.21 functions supported are: 

e Abbreviated Address Calling 

e Charge Transfer 

e Closed-User Group 

e Closed-User Group with Outgoing Access 

e Direct Call 

e Incoming Calls Barred 

¢ Outgoing Calls Barred 

e Registration/Cancellation of User Facilities 

e Redirection of Call 

e Registered Private Operating Agency (RPOA). 
The 5294 supports X.21 digital network communi- 


cations and the SNA/SDLC protocol when exchanging 
information with host systems. 


5294 Interchange Connector 


The X.21 interface between the 5294 as a Data Ter- 
minal Equipment (DTE) and the network Data Circuit- 
terminating Equipment (DCE), complies with the 
International Organization for Standardization (ISO) 
Data Communications 15-pin DTE/DCE Interface Con- 
nector and Pin Assignments, International Standard 
(IS) 4903. Balanced Voltage digital interface commu- 
nications circuits are used. 


Connector Assignments 


Connector Direction of 
Pin Transmission 
1 Not Used: Shield 
Ground 


2 emconera fooce 


S(A) Signal Element |from DCE 
Timing A 

Not Used: Byte 
Timing A 
“eases foes 


B) Signal Element |to —— 
aa B 
Not Used: Byte 
Timing B 
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The 5294 supports the following X.21 signaling cir- 
cuits. Byte Timing is not implemented. The electrical 
characteristics comply with EIA Standard RS422 and 
CCITT Recommendations X.24/27(V.11). 


e Circuit T: Transmit Pair T(A) and T(B) 


During call establishment phase and call clearing 
phase, binary call control signals, originated by 
the 5294, are transmitted to the local DCE over 
circuit T. During data transfer phase, binary data, 
originated by the 5294 and intended for trans- 
mission to the host system, is transmitted to the 
local DCE over circuit T. 


e Circuit R: Receive Pair R(A) and R(B) 


During call establishment phase and clearing 
phase, binary call control signals, originated by 
the network or the local DCE, are transmitted to 
the 5294 over circuit R. During data transfer 
phase, binary data as received from the host 
system is transmitted to the 5294 over circuit R. 


e Circuit C: Control Pair C(A) and C(B) 


During call establishment phase, if this circuit is 
in the on condition, the call control signals on 
circuit T informs the local DCE of the 5294 state 
or status. During data transfer phase, circuit C is 
on continuously. During quiescent and call 
clearing phase, circuit C is off. 


e Circuit |: Indicate Pair I(A) and I(B) 


When Circuit | is on, this indicates to the 5294 that 
the call end-to-end condition has been estab- 
lished and any signal on circuit R contains infor- 
mation from the host system. When circuit | is off, 
the DCE has indicated that signals on circuit R 
are network controls. 


e Circuit S: Signal Element Timing Pair S(A) and 
S(B) 


Circuit S provides timing or clock signals to the 
5294. 


Communication Codes 


The 5294 Control Unit with the X.21 Switched-Circuit 
feature can receive messages and exchange informa- 
tion with the network by using the International 
Alphabet No. 5 7-bit code. The received messages 
can contain a limited selection of the following char- 
acters: 


e Decimal digits 0 through 9 
e Control characters: 


— BEL 
— SYN 
—- $i 


The 5294 responds to DCE-defined network messages 
such as number busy, access barred, and changed 
numbers. The 5294 also recognizes Call Progress 
Signals (CPS) starting with Shift-In (SI) characters. 
Other DCE network information received by the 5294 
is discarded and no operator messages are posted. 


The 5294 supports the transmission of all Interna- 
tional Alphabet No. 5 codes to accommodate the 
network Registration Facility usage, but it does not 
perform message syntax checking. Data entered by 
the operator is translated from EBCDIC to IA5 charac- 
ters with odd parity and sent to the network. If a key- 
board character not included in the IA5 character set 
is entered, the 5294 translates that entry to a NULL. 


The 5294 assures that the transmitted network mes- 
sages are appended with a + character delimiter. 
The delimiter is either entered by the operator or is 
automatically added. 
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The following chart shows the coding for the Interna- 
tional Alphabet No. 5 (IA5) characters: 


IS4 
ae aE Aae ences 
ISS 
1111 
a 


Character Code Table Legend 


TC Transmission Control Characters 


FE = Format Effectors 


DC 


Device Control Characters 


IS = Information Separator 
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The 5294 supports the following 7-bit IA5 control 
codes: 


Control Codes Received 


BEL j|Indicates an incoming call when preceded 
by a minimum of two SYN characters and 
the 5294 is in State 1. 


SYN |Acharacter that precedes all transmissions 


and may be embedded within 
transmissions to maintain synchronization. 


Shift In. Used in Japanese network only. 
Follows SYN SYN and precedes Call 
Progress signals or DCE-provided 
information. 


An ending delimiter that indicates 
end-of-transmission (EOT). 


Indicates the start when a DCE-provided 
change information. Must be preceded by 
SYN SYN and information must be 
followed bya +. 


Indicates the start when a DCE-provided 
calling and called line identification. Must 
be preceded by SYN SYN and information 
must be followed bya +. 


/ A field separator used to separate fields in 
Call Progress signals or DCE-provided 
information. 


Control Codes Sent 


A character that precedes all transmissions 
and may be embedded within 
transmissions to maintain synchronization. 


A character used for fill purposes. The 
NUL character may be inserted into a data 
stream without affecting the information 
content. It is used by the 5294 to replace 
any operator-entered character that does 
not have an equivalent in the IA5 alphabet. 


Indicates the start of an abbreviated 
address selection sequence. Must be 
preceded by SYN SYN, and the address 
must be followed bya +. 


Used to separate Facility Request signals 
within a facility request block that contains 
two or more Facility Request signals, or 
used to separate Facility 
Registration/Cancellation signals within a 
facility registration/cancellation block that 
contains two or more Facility 
Registration/Cancellation signals. 


Used to separate fields (request code, 
indicator, parameter, or address) within a 
Facility Registration/Cancellation signal. 


Terminating delimiter of facility request or 
facility registration/cancellation blocks. 
Must be followed bya +. 


Ending delimiter used to indicate the 
end-of-transmission (EOT). Used for all 
transmissions. 


If preceded by SYN SYN and terminated 

by a +, the sequence nnn...n is an address 
selection sequence. If preceded by SYN 
SYN and terminated by a- andthena +, 
the sequence nnn...n is a facility block. 
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Since there are only four electrical signal lines (two 
from the DTE to the DCE and two from the DCE to the 
DTE), the meaning of the signals is dependent upon 
the previous state. A description of the X.21 interface 
states follows. 


Note: Communication over a public switched data 
network is possible using SDLC only when con- 
necting to the network through a DCE using the 
X.21bis interface via the EIA feature; however, only a 
limited set of functions is available. Also, this option 
may not be available for all networks. When allowed 
by the network, operation is possible between a DTE 
using X.21bis on one end and a DTE using X.21 
(X.24/X.27) on the other end. 


X.21 Switched Circuit Operations 


The operation of work stations attached to the 5294 
Control Unit is based on interactive terminal support 
and is dependent on the communications link. A call 
must be established and the data link must be con- 
nected for work station operation. With the X.21 
Switched Circuit feature, the 5294 supports automatic 
call establishment (call is made following a work 
station keystroke sequence) and automatic call 
clearing. The host system or a 5294 work station 
operator can initiate the call or call clearing. 


Following power-on and successful power-on diag- 
nostics, the 5294 places the attached work stations 
into free key mode. The work stations are set up with 
the entire display being one input field and the 
printers are inoperative. The input field format word 
is set to alpha shift with no Field Exit key required. 
Mandatory entry, auto record advance, right adjust, 
and mandatory fill are not supported. Data may be 
entered anywhere on the display. 


If any Aid generating key, excluding the Sys Req key 
and Enter/Record advance keys is pressed in the 
initial free key mode, operator error code 0099 will be 
posted on the work station display. If a permanent 
link error is posted, the last link error code may be 
displayed instead of the 0099. 


If the communications link is not established, a Sys 
Req keystroke is recognized as an indicator that the 
operator wants to place a call. The 5294 then sets up 
one input field, highlighted with column separators 
between 78 columns, for the operator to enter call 
information or facility requests. 


Normal Call Initiation 


The work station operator initiates a call in the fol- 
lowing sequence: 


e Press the Reset key to ensure there is no device 
error. 


e Press the Sys Req key. 


e Key the network call information into the high- 
lighted input field and press the Enter key. 


The data entered should be the assigned numeric 
network identification code for the appropriate host 
system followed by a plus (+) character as a delim- 
iter or the appropriate network registration request 
code for the desired facility. 


Direct Call Initiation 


The work station operator initiates a direct call in the 
following sequence: 


e Press the Reset key to ensure there is no device 
error. 


e Press the Sys Req key. 
e Press the Enter key. 


Under these conditions, the 5294 makes a direct call 
request. The request is made to the network to place 
a call to a preassigned number supported by the 
network. The 5294 does not send X.21 information in 
the direct call sequence. 


Call Clearing Initiation 
Calls are cleared under the following conditions: 


e The 5294 initiates a call-clearing sequence 
through a DTE clear-request sequence as the 
result of a time-out for transmit call selection 
sequence or as part of an error recovery proce- 
dure. 


e The work station operator initiates call clearing 
when the 5294 is in the data transfer phase and 
prior to entering normal response mode by 
entering the keystroke sequence of Sys Req and 
the character D. 
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Short Hold Mode 


In short hold mode (SHM), the link between two 
stations is established and maintained only when 
there is data to transfer. The 5294 Control Unit sup- 
ports SHM but will not initiate an SHM session. The 
host system determines and controls the SHM opera- 
tion. 


To start an SHM session, either the host system or 
the remote display station initiates a call to the 
network. The call then proceeds as any other X.21 
call sequence. When Ready for Data state is reached 
and the SNA/SDLC operation starts, the host system 
sends a XID command specifying the SHM operation. 


The XID format includes the following fields: 


e SHI: Short Hold Mode indicator (byte 9, bit 7). 
This bit indicates that the XID sender is able to 
operate in SHM. 


¢ SHSI: Short Hold Mode Status indicator (byte 9, 
bit 6). This bit indicates the state, active or reset, 
or the SHM session. 


e SHMDIALN: Short Hold Mode Dial Number (byte 
19). This byte contains the number of dial digits 
of the XID sender. 


¢ SHMDIALD: Short Hold Mode Dial Digits (bytes 
20 through 46 max). This bytes contain the dial 
digits of the XID sender. These digits are of the 
form X‘Fn’ where n = 0-9. 


After SHM is selected by the XID exchange, the host 
system sends an SNA/SDLC SNRM command to start 
the SHM session. At any time in the session when 
the host does not have any frames to transmit or 
acknowledge, the host can clear the connection. 
Either the host system or the remote display station 
can call to reestablish the connection. 


The XID command contains the dial digits for the host 
system to be used by the 5294 Control Unit to recon- 
nect the link. These digits are received in EBCDIC 
code. The 5294 uses these digits on each recon- 
nection to assure that the reconnection ts to the 
correct host. The 5294 also translates the EBCDIC 
codes to the IA5 codes to be used when the 5294 initi- 
ates a reconnection. If SHMDIALN = 0, or if the con- 
figuration bit Direct Call is set on, the 5294 performs 
a Direct Call request to the network for reconnection. 


In SHM, when a work station has data to be sent to 
the host system, and the X.21 connection is not made, 
the 5294 uses the dial digits that were received in the 
XID command and makes the reconnect call. When 
the reconnection is made and the X.21 Data Transfer 
phase is entered, the host system must send an XID 
with the SHM status on to continue the same SHM 
session. After the XID exchange, the host sends an 
SNA/SDLC RR command to enable the 5294 to send 
the work station data. 


The host system terminates the SHM session by 
sending the DISC command and then clearing the 
connection. The 5294 interprets the Clear Requests 
received during NRM as SHM line disconnects and 
maintains the SNA session in progress. An SHM 
reconnection is necessary to either continue the 
session or to terminate the session. 


XID Format 


The 5294 only responds to an XID command in either 
Format 0 or Format 1. The 5294 does not issue the 
XID command. The XID command or response is 
identified in the SDLC unnumbered frame control 
field modifier bits as shown below: 


10111 = XID Command or XID Response 


The host system sends the code to solicit an XID 
response from the 5294 whenever a session is to be 
established or reconnected. The SDLC frame infor- 
mation field can be in either Format 0 or Format 1 as 
defined below. 


The 5294 will send the code to the host system after 


an XID command has been received. The SDLC 
frame information field will be in Format 1. 
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Format XID | 
Field. 


| jos [xi Format 


4-7 Sending Node *X’1’ = PU Type 1 (T1). 
Type. 


Node 
Identification. 


Block Number. * X’045’ = 5294 + x'045" = 5294Block#. | + x'045" = 5294Block#. | 
Rr 231 [IDNumber, ff 
"oest | ~”~«d xe’ = SLC Station Address. 
|| endtorrormato. | 

Bytes 6-p for 
Format 1. 
B57 [ove [Reserves [ooo 
Link Protocol 
Flags. 
Transmission = Sender is secondary. 
Type. 


Transmission *X’0’ = oe duplex. 
Mode. 


Sender Node 
Characteristics. 
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a a Value/Description 


Segmenting is not|* X’3’ = Whole BlUs only. 
supported. 


Ts Reserves, 
= Short Hold Status.|* B’ a = a. << SHM. 


Short Hold 7 ee 0’ = SHM not supported. 
Support. 


_ 11 {0-15 Maximum | Field |* ee 105’ = 261 bytes. 
eas 


0-7 |SDLC Profile. SDLC Profile. | * X’00’ = Only value defined. 


ol 
Option. 
Te fones._—=*ie = Netsppore 
ee 
a CO 
[or |peorves Few, 
Fxwor. 


m 
= 
~] 


Maximum Number* X’1’ to X’7’ for displays. 
of | Frames 
Received. 


ee * X’1’ to X ’3’ for printers. 
inne sa | 


8 


Short Hold 
Parameters. 


Dial Digits p = 
Byte 46 
Maximum. 


NO a ee 9 —_h a ae a Oe ee 9 
oO oOo} © @ > 
a @) oe 

on 
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Call Retry Attempts 


An unsuccessful call may be retried by the operator 
but the success may be determined by the network 
call progress signal response. The 5294 does not sig- 
nificantly control these actions. 


X.21 Network States 


The 5294 Control Unit supports the X.21 interface 
states as defined in the CCITT Recommendation X.21: 
Interface between Data Terminal Equipment (DTE) 
and Data Circuit Terminating Equipment (DCE) for 
Synchronous Operation on Public Data Networks 
(Geneva, 1972; as amended 1976 and 1980). The fol- 
lowing information identifies the specifics for 5294 
operation. 


The following circuit reference conditions are used to 
describe the 5294 operations: 


Symbor wea [Name [oonions 


Initial Conditions Following Power On 


Circuit T 


Following power-on reset, the 5294 is initialized to an 
uncontrolled not ready (clear request to DCE) with 
circuits t = 0 andc = Off. This condition will remain 
during successful power on diagnostics, which is 
approximately 5 to 10 seconds. The 5294 does not 
check the state of the DCE during this period. Cir- 
cuits R and | can be in any condition during this 
period. The 5294 then presents Ready to the DCE 

(t = 1 andc = Off) and immediately starts looking 
for SYN characters on the receive line. 


Receive Conditions 


An incoming call from the DCE will be signified by a 
BEL character preceded by two or more contiguous 
SYN characters. The 5294 then accepts the call 

(t = 1 andc + On) unless there is a call collision. 


The 5294 will only receive X.21 network messages in 
the call establishment phase. Data will be received 
only if it was preceded by two or more contigious 
SYN characters and the 5294 is in the DTE waiting 
state (t = 1 andc = On), or if the 5294 transmit oper- 
ation is active. Otherwise, the incoming data will be 
ignored. 


The 5294 recognizes the first plus (+) character in 
the message as the end of data as shown below. 


SYN--SYN, IA5,---,IA5, PLUS, IA5----- Incoming Data 
Stream 


Discard Data 


Plus Delimiter 
(end of receive data) 


Data Received 
(If data is BEL, it is removed.) 


Starting Sequence 
(SYN characters are removed from the data.) 


When Ready for Data state is received, the 5294 will 
switch automatically to the SNA/SDLC operation. 


The SNA/SDLC operation will be terminated if 17 
zeros have been received with i = Off (X.21 DCE 
Clear). 
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Transmit Conditions 


X.21 is a full-duplex protocol; therefore, the 5294 
transmit will not be enabled unless receive is active. 
This is necessary to receive and report network 
response to Call Request. When transmit is enabled, 
the 5294 will progress through the calling states: Call 
Request, Proceed to Select, Selection Signals, DTE 
Waiting. Following Proceed to Select, State 3 

(r = plus characters and i = Off), the 5294 will typi- 
cally transmit 2 SYN characters followed by the 
message characters or the select data, and the end of 
message delimiter (plus character). The 5294 will 
then transmit continuous ones (1s) that signal DTE 
Waiting State until either the Ready for Data State (r 
= 1 andi = On) ora Call Clear Command (r = 0 
and i = Off) is signaled by the DCE. 


If a direct call is initiated, the 5294 bypasses the 
Selection Signal State 4 and does not transmit SYN 
and other IA5 characters. In this case, the 5294 will 
immediately transmit continuous ones (1s) that signal 
DTE Waiting State. The Control circuit will be on for 
24-bit times (c = 1) before the 5294 initiates data 
transfer (Circuit T held at t = 1). 


DCE Clear 


The DCE is required to respond to a 5294 Clear 
Request with a Clear Confirmation (r = 0 and 

i = Off) followed by a DCE Ready signal (r = 1 and 
i = Off). 


For all DCE initiated clearing, DCE Clear Indication 
(r = O andi = Off), the 5294 responds with a DCE 
Clear Confirmation (t = 0 andc = Off). 


Call Collisions 


Call collisions can occur under the following condi- 
tions: 


e A network incoming call is indicated concurrently 
with or immediately after the 5294 sends a Call 
Request. 


e A network incoming call is indicated while the 
5294 is processing an operator-initiated call. 


If the DCE indicates an incoming call (r = 
SYN,SYN,BEL andi = Off) during or immediately 
after the 5294 has sent a call request (t = 0 and 

c = On), the 5294 takes no action. The DCE either 
drops the incoming call and proceeds with the Call 
Request selection sequence or attempts to establish 
the incoming call. If the DCE drops the incoming call, 
that call is not recognized. If the DCE attempts to 
establish the incoming call, the 5294 utilizes the Call 
Request sequence time out to initiate a call clearing 
action. 


If the work station operator is in the process of 
making a call (Sys Req keystroke made and Call 
Request not yet sent to the DCE) and an incoming call 
is indicated, the 5294 will post an error to the oper- 
ator and log the error. The 5294 will then send a 
Clear Request to the DCE (t = 0 andc = Off). 


In the CCITT recommendation X.21, the condition of 
the interchange circuits determines what is hap- 
pening at the interface. During a data communi- 
cations operation, the DTE uses the transmit (T) and 
control (C) interchange circuits to signal the DCE 
what action to take. The DCE uses the receive (R) 
and indication (Il) interchange circuits to signal the 
DTE what action to take. 
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Figure 2-24 lists the interface states that are defined , ) 
by recommendation X.21. 


ae ae se ee ee 
(SR are ET] 


DTE DTE DCE Time-Limit/ | Terminated 
State Circuits Transition Transition To by 


Name to State No. State No. State No. : State No. 


Ready 

Call request 

Proceed to select 

Selection signal 

DTE waiting 

DCE waiting ; 

DCE waiting 10bis,11,12 

Call progress signal 6A,10,11,12 T3B 7,10,12,19 
Incoming call 9,15 
Call accepted 10bis,12,19 
DCE provided information 

DCE provided information 

Connection in progress 

Ready for data 

Data transfer 

Receive data 

Send data 

DTE controlled not ready 

DCE ready 

Call collision 

DTE clear request 


DCE clear confirmation 
DTE ready 

DCE not ready 

DCE not ready 


DCE clear indication wi” 


DTE clear confirmation 

DCE ready 

DTE uncontrolled not ready 
DCE not ready 

DTE controlled not ready 
DCE not ready 

DTE uncontrolled not ready | 0 
DCE ready 


1. DCE clear indication (state 19) or DTE clear request (state 16) may be entered from any state except ready (state 1) 
2. Other transitions are not considered valid. 


Figure 2-24. X.21 Interface State Transitions and Applicable Time outs 
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Interface State Diagrams 


Recommendation X.21 defines those transitions 
between interface states that are allowed by all tele- 
communications administrations. The recognized 
state transitions for each of the four phases of a data 
communications operation are shown by means of 
state diagrams. Figure 2-25 shows the definitions for 
the symbols that are used in the state diagrams. 
Figure 2-26 shows the states used for nonswitched 
operation (X.21 nonswitched public data network or 
X.25 packet-switched network). Figure 2-27, 

Figure 2-28, and Figure 2-29 show the states used 
for X.21 circuit-switched public data network opera- 
tion. 


State with One Set 
of DTE/DCE Signals 


n 
State Name 


n = State number 
t = Signal onT circuit 
Cc = Signat C circuit 
r = Signal on R circuit 
= Signal on! circuit 
T = Transmit interchange circuit 
C = Control interchange circuit 
R = Receive interchange circuit 
| = Indication interchange circuit 
D = DTE or DCE data signals 

State with a Family of » a: ready Binary : poe tn 

DTE/DCE Signals 1 = Steady binary 1 condition 
01 = Alternate binary 0 and binary 1 
Off = Continuous off (binary 1) 

State Name On = Continuous on (binary 0) 
IA5 = Characters from International Alphabet 
ri Number 5 (CCITT Recommendation V.3) 

BEL = JA5 character, 0/7 
SYN = IJA5 character, 1/6 
- = lA5 character, 2/11 
a = Transition between states 


Figure 2-25. Definitions of Interface State Diagrams 
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1 
(DTE Ready, 
DCE Ready) 


13R 


13S 
Send Data 


DCE 


DCE 
Not Ready 


1, Off or D, On 
O, Off 


Receive Data 


13 


Data Transfer 


Figure 2-26. Data Transfer Phase Interface State Program: X.21 Nonswitched Public Data Network or X.25 Packet- 


Switched Network Operation with X.21 Electrical (X.24/X.27) Interface 
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1 
Ready 
(DTE Ready, 
DCE Ready) 


DTE Uncontrolled 
Not Ready, DCE Ready 


DTE Controlled 
Not Ready, DCE Ready 


22 
DTE Uncontrolled 
Not Ready, 
DCE Not Ready 


23 
DTE Controlled 
Not Ready, 
DCE Not Ready 


18 
DTE Ready, 
DCE Not Ready 


Note: The DCE and DTE (5294) must signal each state for at least 24 bit-times or until 
the DCE or DTE indicates that the state has been recognized by changing states, whichever is less. 
The DTE (5294) must not change states as a result of the DCE changing state until the DCE-signaled 


state has existed for at least 16 bit-times. 


Figure 2-27. Quiescent Phase Interface State Diagram: Circuit-Switched Operation 
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Calling States Common States Called States 


D CE 
2 8 
Call Request Incoming Call 
1, Off 
— 
Call Collision DTE 
0, On 
3 BEL, Off 9 
Proceed to Select Call Accepted 
1, On 
BEL, Off 
DCE 


DTE 


4 6B 
Selection Signals DCE Waiting 
[A5, On 
+, Off 
5 DCE 
DTE Waiting DCE 
be C i tl 
onnection 
ERE 1G EROgIess DCE- Provided 
Information 
6A 1, On 
DCE Waiting IAS, Off 


oe, 12 
DCE a Ready for Data 
DCE-Provided 
Information 
1, On 13 
IAS, Off Data Transfer 
D, On 


D, On 


Figure 2-28. Call Establishment Phase and Data Transfer Phase Interface State Diagram: Circuit-Switched Operation 
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Switched Network Calling and Answering Sequences 


The following table shows the sequence of states, 
pictured in the state diagrams on the preceding 
pages, that are used for calling and answering on an 
X.21 switched network. The condition of the transmit 
data, control data, receive data, and indicate lines for 
the X.24/X.27 (XLCA) interface between the 5294 and 
the DCE is also shown. 


The sequence shown is for normal operation. Most 
states have time outs for error recovery. Figure 2-24 
shows the time outs applicable to each state and the 
state entered if the time out expires without the 
expected state transition. 
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Switched Network Calling Sequence 


The 5294 and the DCE are}1 
ready for transfer. 

The 5294 asks the DCE to 
place a call. 

The DCE responds with a 
Proceed to Select signal. 


The 5294 responds with |SYNSYN 
selection signals. This selection 
state is bypassed for signals + 
direct call. 


DCE waiting. This state 
may be bypassed for 
some Calls. 


state). 


The DCE signals that the 
connection has started 
(Optional state). 


The connection to the 
remote station is 
complete (ready for 
data). 


The data transfer can 
start. Data transfer is 
performed using 
SNA/SDLC protocols in 
half-duplex mode. SDLC 
operation is the same as 
SDLC switched operation 
after a call is established. 


7-10 The DCE responds with a SYN SYN 
Call Progress signal. The Call 
DCE is placing a call toa Progress + 
remote station (optional 


2-208 IBM 5250 Information Display System Functions Reference Manual 


Switched Network Answering Sequence 


State |Description =| Description =| Transmit Controt. [Receive Indicate 


The 5294 and the DCE are|1 

ready. 

The DCE indicates an SYN SYN 
incoming call. BEL... 

The 5294 accepts the 1 BEL... Off 
incoming call. 


The DCE signals that the 
connection has started. 


This state may be 
bypassed. 


The connection to the 
host system is complete 
(ready for data).’ 


The data transfer can 
start. Data transfer is 
performed using 
SNA/SDLC protocols in 
half-duplex mode. SDLC 
operation is the same as 
SDLC switched operation 
after a call is established. 


After data transfer is complete, the call clearing 
phase is entered (see Figure 2-29 and the Switched 
Network Call Clearing Sequence table following). 
The host system causes the 5294 to initiate call 
clearing by sending an SDLC Disconnect (DISC) 
command. 
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Switched Network Call Clearing 


(see note) 


16 


DTE Clear Request DCE Clear Indication 


21 


DCE Clear Confirmation 


DCE Ready DTE Clear Confirmation 


O, Off DCE DCE O, Off 
O, Off O, Off 


DTE 


1 
Ready 

(DTE Ready, 

DCE Ready) 


Note: This may be any state shown in Figure 2-24 except the ready state (1). 


Figure 2-29. Clearing Phase Interface State Diagram (Circuit-Switched Operation) 
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Switched Network Call Clearing Sequence 


The following figures show the sequence of states 
pictured in the state diagram on the preceding page 
that are used for call clearing on an X.21 switched 
network. 


Note: The active levels for X.21 signals are: 
0 for data lines 


On for control lines. 


Call Clearing after Normal Data Transfer Operation 


The 5294 recognizes the |1 
end of data transfer as a 
result of receiving an 

SDLC DISC command 

from the host system. 


The 5294 initiates call 
clearing by sending a 
clear request to the DCE. 


Data (SDLC 


The DCE recognizes the 
end of the data transfer 


The 5294 returns to the 1 
ready state. 
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Call Clearing after Facility Registration or a 5294-Detected Error 


State [Descipton ____[Tranamit[eonrai [Resale [ndone 


XX The 5294 recognizes that 
a call clearing is required 
due to facility registration 
complete or a detected 


16 The 5294 signals a Clear Can be 0/1 |Can be On/Off 

Request to the DCE. 
The DCE acknowledges 
the Clear Request from 
The DCE returns to the 
ready state. 

The 5294 returns to the 
ready state. 

XX The DCE/network 
recognizes that a call 
clearing is required due 
to an error or a Clear 
Request by the remote 
(host system) DTE. 
The DCE signals a Clear |Can be0/1 |Canbe 
Indication to the 5294. On/Off 
The 5294 acknowledges 
the Clear Indication from 
the DCE (a DTE Clear 
confirmation). 

21 The DCE returns to the 
ready state. 

1 The calling station returns| 1 1 Off 
to the ready state. 


the 5294 (a DCE Clear 
confirmation). 
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SDLC Counter Error Codes (X.21) 


The 006X error codes are for SDLC. They are placed 
in the error log when the 5251 Model 2 or Model 12 
counters that track SDLC transmission errors over- 
flow or when the host system solicits the error log. 
The operator may display the counters that are for- 
matted into these errors. See Problem Determination 
Procedures in the /BM 5257 Display Station Models 2 
and 12 Operator’s Guide, GA21-9323, or the 5294 
Operator’s Guide, GA21-9370. See the index entries 
errors, error log; errors, handling; and reqms 
command. 


The following chart describes each SDLC error code. 


0060 Bad test counter 
Used with the SDLC Test command for diag- 
nostic purposes. 


0061 Good test counter 
Used with the SDLC Test command for diag- 
nostic purposes. 


0062 Communications adapter underrun counter 
0063 Communications adapter overrun counter 
0064 Carrier detect glitch counter 


Occurs when the carrier detect line is 
unexpectedly inactive. 


0065 Clear to send glitch counter 
Occurs if the clear to send line is 
unexpectedly inactive. 


0066 Data set ready glitch counter 
Occurs if the data set ready line is 
unexpectedly inactive. 


0067 Frame sequence error counter 
Occurs when frame sequence errors occur. 


0068 


0069 


006A 


006B 


006C 


006D 


OO6E 


OO6F 


Transmit retry counter 

Occurs each time an | frame must be 
retransmitted. 

CRC errors in FCS field 

Occurs each time the FCS character does 
not match the expected FCS character. 
Frame aborts received 

XLCA card detected errors 

Call collision detected 


IA5 parity error 


Number of | frames transmitted by the 5294 
(4 bytes) 


Number of | frames received by the 5294 (4 
bytes). 
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Operator Error Codes (X.21 Switched 
Support Feature Only) 


If the 5294 has the X.21 Switched Support feature and 
an error occurs during the keyboard entry of com- 
mands, or options, or parameters, a 6-digit error 
code (such as 20xxxx, where xxxx represents 4 
hexadecimal digits) is displayed. A description of 
these codes follows: 


200000 A Call command is already in progress (not 
in session). 


Wait until the Call command is complete, or an error 
code other than 200000 is displayed. 


200100 The switched circuit has been successfully 
disconnected. 


The operator may make another call. 


200200 _ +=The operator attempted a Detach command 
while the Call command was in progress or no 
command was in progress. 


Wait until the previous command completes; then try 
again. If no command was in progress, try to make a 
call. ; 


201100 The host network is busy at the address 
keyed in. 


Wait until the host system is not busy, or try a dif- 
ferent address. 


X.21 Communications Errors (X.21 Switched 
Support Feature Only) 


If the 5294 Control Unit accepts the keyboard-entered 
options, but the network operation with the host 
system fails, a code that indicates the type of commu- 
nications problem is displayed on the attached work 
stations. 


The 21xx00 error codes occur when a call is in 
progress with the host system. The cause of the 
error is contained in the field xx. The codes that are 
valid follow: 


210000 Reserved. 


210100 The terminal called the host system. 


Wait one minute or until an error code other than 
20xx00 is displayed. This status is temporary. 


210200 The call is being redirected. 


Wait one minute or until an error code other than 
20xx00 is displayed. This status is temporary. 


210300 Connect when free. 


Wait one minute or until an error code other than 
20xx00 is displayed. This status is temporary. 


212000 + There is no connection. 


Ensure that the number called is correct and try the 
operation again after one minute. This is a DCE ora 
network error. 


212100 The number is busy. 


Ensure that the number called is correct and try the 
call again. If the number is busy for longer than 
normal, call the host system to see if the system port 
for the number called is actually busy. If the host 
system port and the DCE for the number called is 
ready and not busy, there is a network problem. 


212200 + There is a procedure error in the selection 
signals sent to the network. 


Ensure that the operating procedures are correct and 
try the operation again. If the same failure occurs, 
the problem is caused by the DCE or the network. 


212300 +#£There is a transmission error in the 
selection signals sent to the network. 


Ensure that the number called is correct and try the 
operation again after one minute. This is a DCE ora 
network error. 


214100 Access is barred to the network. 


Ensure that the number called is correct and that the 
operating procedures and configuration are compat- 
ible with the network subscription for the 5294 and 
the host system locations. If the procedures and con- 
figuration are correct and compatible, the failure is a 
network problem. 
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214200 The number you are calling has changed. 
Ensure that the number called is correct and that the 
operating procedures and configuration are compat- 
ible with the network subscription for the 5294 and 
the host system locations. If the procedures and con- 
figuration are correct and compatible, the failure isa 
network problem. 


214300 
reached. 


The number you are calling cannot be 


Ensure that the number called is correct and that the 
operating procedures and configuration are compat- 
ible with the network subscription for the 5294 and 
the host system locations. If the procedures and con- 
figuration are correct and compatible, the failure is a 
network problem. 

214400 The number you called is out of order. 
Ensure that the number called is correct, that the 
called system and DCE are powered on and ready, 
and that the 5294 has been varied on. If both the host 
system and its attached DCE are powered on and 
ready, and the 5294 is varied on, then the failure is 
due to a network problem. 


214500 Called DTE; controlled not ready. 


Same as 214400. 
214600 Called DTE; uncontrolled not ready. 
Same as 214400. 

214700 Called DTE; power off. 
Same as 214400. 

214800 _ ~=s The facility request code is not valid. 
Ensure that the facility request code is correct and 
that the operating procedures and configuration are 
compatible with the network subscription for the 5294 
and the host system locations. If all of the above are 
correct and compatible, the failure is a network 


problem. 


214900 There is a network problem in the local 
loop at the DCE you called. 


The problem is caused by the network or by the DCE. 


215100 The number called cannot be obtained. 
Ensure that the number called is correct. If the 
number called is correct, call the network information 
service to find out why the number called is tempo- 
rarily not obtainable. 

215200 The user class of service is not compatible. 
Ensure that the number called is correct and that the 
operating procedures and configuration are compat- 
ible with the network subscription for the 5294 and 
the host system locations. If the procedures and con- 
figuration are correct and compatible, the failure is a 
network problem. 

216000 There is no connection. 

Ensure that the number called is correct and try the 
operation again after one minute. This is a host 
system DCE or network problem. 

216100 The network is congested. 

Ensure that the number called is correct and try the 
operation again after one minute. This is a network 
problem. 


217100 There is long-term network congestion. 


The failure is caused by a network problem. 


217200 The Recognized Private Operating Agency 
(RPOA) is out of order. 


Ensure that the number called is correct. The failure 
is caused by an RPOA or a network problem. 


218100 The registration/cancellation is confirmed. 


This is not an error. It is part of the procedure used 
to initialize a call and a confirmation of the facility 
registration/cancellation, not an error. 

218200 #£The redirection of the call was activated. 


This is not an error. It is a confirmation of the facility 
registration activation, not an error. 
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218300 The redirection of the call was deactivated. 
This is not an error. It is a confirmation of the facility 
registration deactivation, not an error. 

220000 = An invalid XID was received. 

Ensure that the number called was correct. There is a 
host system programming error or a configuration 
problem. 
220100 An invalid XID was received. 

Ensure that the number called was correct. If the 
number called was correct, there is a host system 
programming error or a configuration problem. 
220200 The wrong XID was received. 

Ensure that the number called was correct. Ifthe 


number called was correct, there is a host system 
programming error or a configuration problem. 


220300 A XID was required and was not the first 
thing received. 


Ensure that the number called was correct. If the 
number called was correct, there is a host system 
programming error or a configuration problem. 


220400 
selection. 


A DCE Clear was received during call 


The failure is caused by a network or DCE problem. 


220500 
message. 


There was a transition to SDLC during a 


The failure is caused by a network or DCE problem. 


220600 
buffer. 


An X.21 message was too long for the 


The failure is caused by a network or DCE problem. 


220700 An attempt was made to send an X.21 
message to the network in SDLC state. 


Contact your 5294 Control Unit service representative 
and report the error code. 


220800 An attempt was made to send an SDLC -) 
frame to the network in X.21 state. 


Contact your 5294 Control Unit service representative 
and report the error code. 


220900 An X.21 message was received in the not 
ready queue. 


Contact your 5294 Control Unit service representative 
and report the error code. 


221000 A time-out T1 was received for a Proceed- 
to-Select response. 


The failure is caused by a network or DCE problem. 


221102 A time-out T2 was received for a Selection 
Signal response. 


The failure is caused by a network or DCE problem. 


221103 A time-out T3A or T3B was received for a 
Call Progress signal response. 


The failure is caused by a network or DCE problem. J 


221104 A time-out T4 was received for a Call 
Accepted response. 


The failure is caused by a network or DCE problem. 


221300 Acall collision error occurred. 

Try the operation again. If the error occurs again, 
contact your 5294 Control Unit service representative 
and report the error code. 


221400 Aclear command was received from the 
network during an X.21 data transfer (SNA/SDLC 
mode). 


Ensure that the number called is correct. If the 
number called is correct, there is a host system or 
network problem. 


23xx00 #Acall progress signal was received from 
the network, but a call was not placed. 


The failure is caused by a network or DCE problem. 


» 
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( 240000 Acall progress signal was received that 
was not valid. 


The failure is caused by a network or DCE problem. 
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Appendix A. Acronym and Abbreviation List 


+rsp 
-rsp 


CD 
CF 
CFI 


CF2 
Cmd 
CMDR 
Cpl 
CR 
CRC 
CRT 
CU 
Dactlu 
DCE 
Del 
DFC 
DISC 
DM 
dsp 
DSR 
DTE 
Dual CF 
Dup 


EB 
EIA 
ERP 
ESC 


positive response 
negative response 


address 

activate logical unit 
asynchronous disconnect mode 
attention identification 
alphabetic 

asynchronous response mode 
attention 

awaiting field exit required 


binary 
basic information unit 
bits per second 


column 

control field 

control character 

Consultative Committee on International 
Telephone and Telegraph 

change of direction 

Cluster feature 

Cluster feature or first half of Dual Cluster 
feature 

second half of Dual Cluster feature 
command 

command reject 

characters per inch 

carriage return 

cyclic redundancy check 
cathode-ray tube 

clear unit 

deactivate LU 

data circuit terminating equipment 
delete 

data flow control 

disconnect 

disconnected mode 

displacement 

data set ready 

data terminating equipment 

Dual Cluster feature 

duplicate 


end bracket 

Electronic Industries Association 
error recovery procedure 
escape character 


exception request 


flag 

frame check sequence 
field control word 

full duplex 

field exit required 

forms feed 

field format word 

first in chain 

function management 
function management data 
function management profile 
format 

see FIC 


half duplex 
hexadecimal 


information 

insert cursor 

identification, identifier 
input/output 

intelligent printer data stream 
isolated pacing response 

link access protocol-balanced 
light-emitting diode 

line feed 

last in chain 

see LIC 

lines per inch 

local session identifier 
logical unit 

logical unit status 


modify data tag 
mandatory enter 
mandatory fill 

middle in chain 

see MIC 

maximum print line 
maximum print position 


normal disconnect mode 

new line 

station receive 

normal response mode 

station send 

nonsequenced acknowledgment 
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revr 


Rec Adv 
Rec Bksp 


Recfms 
RGA 
REJ 
req 
Reqms 
RH 
RNR 
ROL 
RQD 
RQE 
RR 
Rshutd 
RU 


SARM 
SBA 
SC 
SCS 
SDLC 
SDT 
SF 
SGEA 
SHF 
SIM 
SNA 
SNBU 
Sndr 
SNRM 
SOH 
SREJ 
Ss 


SSCP 
STSN 
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nonsequenced information SVC 


null SVF 

numeric S0,S1, 
S2 

original equipment manufacturers 

only in chain TH 
TS 

path information unit TSP 

print position 

post telegraph telephone WTD 

physical unit 

permanent virtual circuit X 
XID 

queued response indicator XX 

row 

repeat to address yy 

receiver 

record advance Zz 


record backspace 

record formatted maintenance statistics 
remote go ahead 

reject 

request 

request maintenance statistics 
request/response header 
receiver not ready 

request on line 

request definite 

request exception 

receiver ready 

request shutdown 
request/response unit 


set asynchronous response mode 
set buffer address 

system control, session control 
standard character string 
synchronous data link control 
start data transfer 

start of field 

set graphic error action 

set horizontal format 

set initialization mode 

system network architecture 
switched network backup 

sender 

set normal response 

start of header 

selective reject 

system services (control point), Supervi- 
sory session 

system services control point 

set and test sequence numbers 


switched virtual circuit 
set vertical format 
sense bytes 


transmission header 
transmission services 
transmission services profile 
write to display 

hexadecimal 

exchange identifier 
variables 


variables 


variables 


Glossary 


-rsp (negative response). SNA coding that identifies 
an error. See the index entry negative responses. 


+rsp (positive response). The return code that indi- 
cates that data has been received in a way accept- 
able to the receiving partner. 


active field. A field in which the operator has begun 
entering data. Once the field is active, all field 
requirements must be satisfied before the operator is 
allowed to exit the field. See the index entry fields. 


Aid codes (attention identification codes). A byte 
sequence that is generated when the operator 
presses certain function keys. See the index entry 
aid generating keys. 


BIU (basic information unit). The RH and the RU. 
See index entries RH and RU. 


CC (control characters). Formatting control of data 
for both the display and printer LUs. See the index 
entry control characters. 


CD (change of direction). A bit in the RH that deter- 
mines which SNA session partner has the right to 
transmit data. See the index entry CD. 


CF (Cluster feature). A purchasable feature attach- 
able to a 5251 Model 2 or Model 12. It allows the 
user to cable attach up to four work stations to the 
controller. See the index entry cluster feature. 


Cable Thru. A special feature or standard function 
that allows multiple display stations and printers to 
be attached to a single cable path. 


chaining. A process that allows the programmer to 
link RUs together. Bits in byte 0 of the RH identify the 
respective position of each RU within the chain. See 
SNA Terminology Used in Describing the SNA Proto- 
cols in Section 1 and index entry RH. 


condensed printing. Making a standard 
132-character line only eight inches long instead of 
13.2 inches long. This allows use of all 132 print posi- 
tions on standard 8-1/2 in by 11 in forms and an 
increase in line length from 132 characters to 198 
characters. 


controller. The 5251 Model 2 or Model 12 or 5294 
Control Unit that is linked to the host system via an 
SDLC communications network and that has 5250 
devices attached to it via cluster feature. It controls 
the operation of all work stations attached to it via 
Cluster feature. 


controller station address. The 8-bit address that the 
host system uses to address the 5251 Model 2 or 
Model 12. The 5251 Model 2 or Model 12 scans the 
station address field of the SDLC frame for its 
address. 00 and FF are not acceptable as controller 
station addresses. 


D zones (or dezones). Areas where the first 4 bits 
have been removed and replaced with bits 1101. 


data circuit-terminating equipment (DCE). This term 
is used in Recommendation X.25 to refer to the equip- 
ment installed at the user’s premises which provides: 


e All the functions required to establish, maintain, 
and terminate a connection. 


e The signal conversion and coding between the 
data terminal equipment (DTE) and the common 
carrier’s line; for example, a modem. 


The term DCE is also used to refer to functions per- 
formed by a carrier’s network node. 


data terminating equipment (DTE). This term is used 
in Recommendation X.25 to refer to any machine, 
such as the 5294 Control Unit or its host computer, 
that is connected to a network. 


display. The information that the operator sees 
projected on the display screen. 


Dual Cluster feature. A purchasable feature attach- 
able to a 5251 Model 2 or Model 12. It allows the 
user to cable attach up to eight work stations to the 
controller. 


FCW (field control word). A Write command param- 
eter that controls resequencing and self-check (when 
installed) operations. See the index entry field 
control word. 
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FFW (field format word). A Write command param- 
eter that defines the field type. See the index entry 
field format word. 


flag. The unique bit pattern that SDLC uses to iden- 
tify the beginning and end of the SDLC frames. See 
index entries flag sequence and frames. 


frame. A 32-bit (minimum) format that SDLC uses for 
sending commands and data to and from the 5251 
Model 2 or Model 12 and the host system. See the 
index entry frames. 


Note: This term can also refer to the format used by 
the twinaxial commands and responses; in this case, 
the frame is 16 bits. 


Home position. The position that the cursor seeks. It 
can be one of the following: (1) the address sent via 
the IC order, (2) the first nonbypass input field, or (3) 
row 1, column 1. 


IC (insert cursor). A Write command parameter that 
controls the location of the cursor on the display. 
See the index entry /C order. 


immediate commands. The display commands that 
are executed as soon as the controller receives them. 
See the index entry display, commands. 


link access protocol-balanced (LAPB). LAPB is the 
X.25 recommended access protocol used to exchange 
data between a DTE and the network node to which it 
is connected. See also protocol. 


local network address. This is the network address 
of the 5294. Some networks require this to be sent 
with the host network address on a call from the 5294 
to the host system. 


logical channel. A logical channel identifies a virtual 
connection between the 5294 and its network node. 
Permanent virtual circuits are assigned to logical 
channels at subscription time. Switched virtual cir- 
cuits are assigned to logical channels each time a 
connection is set up. The 5294 can use only one 
virtual circuit at a time. A one-way logical channel 
outgoing facility allows the 5294 to call the host but 
will not allow the host to call the 5294. A one-way 
logical channel incoming facility allows the host to 
call the 5294 but will not allow the 5294 to call the 
host. (See also /ncoming Calls Barred and Outgoing 
Calls Barred.) 


logical channel identifier. This is a 12-bit number 
used to identify a logical channel. It consists of a 
4-bit logical channel group number and an 8-bit 
logical channel number. 


LSID (local session identifier). The distinct LU 
address contained in the TH. See the index entry 
addressing. 


LU (logical unit). An SNA term that, in the 5250 con- 
figuration, refers to a work station attached to a 5251 
Model 2 or Model 12 via cluster feature. See 
Description of General SNA Terms Used in This 
Manual under Overview of the 5250 Implementation 
of SNA in Section 1. 


MDT (modify data tag). A bit that flags a field as 
having been altered by the operator. See the index 
entry MDT bit. 


null. This is the hex 00 value, which displays as a 
blank. 


pacing. The rate at which the SNA session partners 
have agreed to transmit data. See the index entry 
pacing. 


packet. Information transmitted through a packet- 
switching network is divided up and inserted into 
packets. These usually consist of control information 
fields giving destination, sequence number, optional 
facilities, and often a user data area. Various kinds 
of packet are used to transmit error codes and super- 
vise the virtual circuit. 


packet size. The packet size is the maximum 
number of bytes allowed in the user data area of a 
data packet. A default value, usually 128 bytes, is 
assigned at subscription time. On some networks, 
the packet size can be altered from call to call. 


packet switching. Packet switching is the transfer of 
data by means of addressed packets that occupy the 
network channel only during actual transmission. 
The channel is available for the simultaneous 
transfer of packets belonging to other network users. 
The network determines the optimum routing of each 
individual packet during, rather than prior to, the 
transmission from a DTE. 


panel. The contents of one full display. 
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permanent virtual circuit (PVC). A permanent virtual 
circuit is the packet switching equivalent of a leased 
line. The 5294 and its host system appear to the user 
to be permanently connected. 


PIU (path information unit). Consists of the TH fol- 
lowed by a BIU. 


port. The hardware coupling used to attach work 
stations to the 5251 Model 2 or Model 12 Cluster fea- 
tures. 


protocol. A series of rules used by SNA to provide a 
common hierarchy and architecture for programming 
in the 5251 Model 2 or Model 12 and host system. 


Queued Response indicator. In a response header, 
the Queued Response indicator denotes whether the 
response is to be enqueued in transmission control 
queues or whether it is to bypass these queues. Ina 
request header, it indicates what the setting of the 
QRI should be on the response. 


regeneration buffer (regen buffer). The reserved 
area of storage within a display LU that holds the 
contents of the display and information about the field 
and screen attributes. 


RH (request/response header). An SNA bit pattern 
that precedes the RU. It defines the RU type, 
response type requested, CD, and position in the 
chain. See the index entry RH. 


RQD (request definite). The receiving partner is 
required to respond to the transmission from the 
other partner. See Description of General SNA 
Terms Used in This Manual under Overview of the 
5250 Implementation of SNA in Section 1. 


RQE (request exception). The receiving partner is 
required to respond only if the response is negative. 
See Description of General SNA Terms Used in This 
Manual under Overview of the 5250 !mplementation 
of SNA in Section 1. 


RU (request/response unit). The programming unit 
that contains all of the 5250 data streams. It is an 
SNA convention. See the index entry RU. 


screen. The hardware device upon which the display 
is projected. 


scan codes. Identification codes sent from the key- 
board to the host system when the operator keys in 
data. 


SDLC (Synchronous Data Link Control). A discipline 
for the management of information transfer over a 
half-duplex communications channel. The configura- 
tion can be point-to-point, multipoint, or loop. SDLC 
includes comprehensive detection and recovery pro- 
cedures, at the data link level, for transmission errors 
that can be introduced by the data communications 
channel. 


session. The logical connection of an LU to the host 
system’s SS or an application program. 


session partners. The host system and the controller 
in the 5251 Model 2 or Model 12 in the 5250 Informa- 
tion Display System. See the heading Description of 
General SNA Terms Used in This Manual under the 
heading Overview of the 5250 !mplementation of SNA 
in Section 1. 


SNA (System Network Architecture). The description 
of the logical structure, formats, protocols, and oper- 
ational sequences for transmitting information units 
through the communications system. 


S53 (supervisory services). The network control 
program supervisor code that provides miscella- 
neous services, such as the communications adapter 
interface, starting channel outputs, controlling timer 
operations, and data manipulation and utility ser- 
vices. 


switched virtual circuit. A switched virtual circuit is 
the packet switching service equivalent of a switched 
line. It allows communication between the 5294 
Control Unit and one of several possible hosts. 
Switched virtual circuits are also known as virtual 
calls. 


TH (transmission header). An SNA bit pattern that 
allows the host system to address data streams to the 
appropriate LU. See the index entry TH. 


virtual circuit. A virtual circuit is a logical connection 
between two DTEs which enables them to exchange 
information according to a standard communications 
procedure with the sequence of information pre- 
served. A virtual circuit occupies transmission 
Capacity only when the data is actually being trans- 
mitted. 
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window. The window size is the maximum number 
of packets that the DTE is authorized to transmit and 
have outstanding at any given time. It is the basic 
flow control mechanism in X.25 and protects the 
network from accepting packets faster than they can 
be accepted by the remote DTE. The window can 
also be used by a DTE to prevent transmission of 
packets from the network if the DTE is unable or 
unwilling to queue them. A default window size, 
usually two, is assigned at subscription time. On 
some networks, this can be altered for a given virtual 
call. 


work station. Either the display station or the printer. 
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Index 


[A] 


absolute print position 2-41, 2-47 
Actlu 
command 2-22 
insessions 1-24 
signon 1-21 
addresses 
local station address 1-5, 1-7 
LSID 1-5, 1-7, 2-1 
station address 1-5, 2-1 
work station address __1-5, 2-1 
addressing 
determining the local station address 1-7 
determining the LSID 1-7 
aid-associated commands 2-5 
aid codes 
commands using 2-2 
keys that generate 2-2, 2-119 
listing 2-1 
aid-generating keys 
Clear 2-119 
Cmd and command function keys 2-120 
Enter/Rec Adv 2-119 
Help (in nonerror state) 2-120 
keyboard layout 2-118 
Print 2-120 
Rec Bksp (Home) 2-120 
Roll (Down) 2-120 
Roll (Up) 2-120 
architecture (see SNA and configurations) 
ASCII 2-2 
Attention 
indicator key 2-121 
Attn key 2-121 
audible alarm 
display 
coding for 2-40 
auto enter field 2-69 


BEL control character 2-42 
Bind command 
description 2-24 
responses 2-25 
sessions 1-4, 1-17, 1-21 


signon 1-21 
bits 

CC 2-39 

CD 1-23, 2-4 

FCW 2-65 

FFW 2-68 

MDT 2-128 

P/F 2-140 

RH 2-141 

RU 2-142 

screen attributes 2-142 
buffer print mode 

description 2-3 

5224 procedure 2-3 

5225 procedure 2-3 
bypass field 2-69 


Cable Thru feature 
addresses (see work station address) 
Cancel command 
description 2-30 
inerrors 1-10 
insessions’ 1-10 
protocol 1-28 
Carrier Return control character 2-43 
CC (control character) 
description 2-39 
display 2-39 
printer 2-41 
CD (change of direction) 
description of 1-23, 2-4 
protocols 1-23 
chaining 1-4, 2-4 
change of direction bit 2-4 
character sets (EBCDIC) 2-51 
Clear Format Table command 2-9 
Clear key 2-119 
Clear Unit command 2-9 
clock feature 2-4 
clocking 2-4 
CMDR 2-17, 2-20 
codes 
aid 2-2 
control characters 2-41 
data stream 2-51 
EBCDIC 2-51 


Index 
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field control word 2-65 
field format word 2-68 
negative response 2-132 
operator error 2-135 
orders 2-136 
screen attributes 2-142 
SDLC error 2-144 
color alignment 2-4 
command function keys 2-120 
command mode 2-146 
commands 
display 
Clear Format Table 2-9 
Clear Unit 2-9 
printer (see control characters) 
Read Immediate 2-5 
Read Input fields 2-6 
Read MDT Fields 2-7 
Read Screen 2-7 
Restore Screen 2-11 
Roll 2-11 
Save 2-8 
Write Error Code 2-12 
Write to Display 2-13 
SDLC 
implementation 1-1 
modes 2-129 
nonsequenced 2-16 
nonsupported 2-21 
supervisory 2-20 
SDLC/SNA relationship 1-2 
SNA commands 
Actlu) 2-22 
Bind 2-24 
Cancel 2-30 
Dactlu 2-31 
Lustat 2-31 
Recfms 2-32 
Reqms) 2-33 
Reqtest 2-33 
Rshutd 2-33 
Signal 2-34 
Unbind 2-35 
SNA implementation 1-3 
common carrier services 
domestic 2-36 
World Trade 2-36 
communications 
description of (see SDLC) 


options 
DDSA 2-51 
EIA 2-65 


1200 bps Integrated Modem 2-160 


2400 or 4800 bps Integrated Modem 2-160 
communications features 2-37 
communications network errors configurations 2-38 
connection signals 2-177 
control characters (CC) 
display 2-39 
printer 
BEL 2-43 
CR 2-43 
FF 2-43 
Fmt 2-43 
IRS 2-47 
LF 2-47 
NL 2-47 
NUL 2-47 
PP 2-47 
control field 2-72 
Copy to Printer feature 2-50 
CR control character cursor 2-43 
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Dactlu command 2-31 
data (see data streams) 
data entry keyboard 1-22, 2-118, 2-122, 2-124, 2-127 
data flow 1-14 
(see also data streams) 
data mode 2-146 
data streams 
description 2-50 
display 2-51 
paths for 1-4 
printer 1-14, 2-51 
DDSA 2-51 
Del key 2-125 
diacritics 2-129 
digital data service adapter 2-51 
DISC command 2-16 
display 
building displays 1-29 
character sets 2-51 
commands 2-4 
control characters 2-39 
descriptions of 
EBCDIC 2-51 
errors on. 1-11 
examples of coding 1-28 
field control words 2-65 
field format word 2-68 
fields 2-69 
orders 2-136 
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protocols 1-24 
reading from 1-37 
screen attributes 2-142 
updating on 1-32 
writing to 1-28 
display indicators 2-73 
Display Mode keys 2-125 
domestic services 2-36 
dup enable field 2-69 


fe 


EBCDIC character set 2-51 
EIA/CCITT adapter 2-65 
ELLC 2-168 
Enter/Rec Adv key 2-119 
Erase Input key 2-125 
errorlog 2-65 
Error Reset key 2-125 
error states 2-145 
errors 
Cancel command 2-30 
codes 
negative responses 2-132 
operator error 2-135 
SDLC 2-144 
description of error handling 1-10 
error log 2-65 
example of error on display 1-38 
Lustat command 2-31 
operator 2-135 
Recfms command 2-32 
Reqms command 2-33 
Reqtest command 2-33 
Rshutd command 2-33 
SDLC 2-145 
Signal command 2-33 
states and modes 2-145 
errors, X.25 2-182 
examples 
display data stream 1-28 
printer data stream 1-39 
Exchange Station Identifier command (XID) 2-17 
expanded cluster feature 2-160 
Expanded feature (see Keylock and self-check fea- 
tures) 


fF 


FCW (see field control word) 
feature 
Copy to Printer 2-50 
Expanded 
self check 2-67 
Magnetic Stripe Reader 2-66 
Selector Light Pen 2-67 
FF control character 2-43 
FFW (see field format word) 
field attributes 
field control words 2-65 
field format word 2-68 
orders 2-136 
screen attributes 2-142 
field control word 
description 2-65 
Magnetic Stripe Reader feature 2-66 
resequencing 2-66 
Selector Light Pen feature 2-67 
Self-Check feature 2-67 
field format word 2-68 
fields 
attributes of (see field attributes) 
resequencing 2-66 
self check 2-67 
types of 2-69 
flag sequence 2-71 
flow 
(see also data flow) 
contents 1-4, 1-12 
definition of 1-23 
types of 
SDLC 1-1 
SNA 1-4, 1-12 
Fmt control character 2-43 
Format control character 2-43 
format levelQ 2-71 
format table 2-71 
Forms Feed control character 2-43 
frames (SDLC) 2-71 
functional information 1-1 


Index 
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graphic Aid codes 2-108 
graphic control orders 2-77 
graphic draw orders 2-90 
graphic set orders 2-80 
graphics 2-73 

graphics orders 2-74 


Ey 


hardware error state 2-145 
HDLC 2-1 

Help key 2-120, 2-121 

hex key 2-125 

Home key 2-125 


a 


lfield 2-72 

| frames 
description 2-72 
responses 2-22 

[/O feature orders 2-102 

I/O field 2-69 

l/O orders 2-74 

IC order 2-137 

IEEE orders 2-102 

IEEE-488 interface 2-109 

immediate commands 
Clear Unit 2-9 
Read Immediate 2-5 
Read Screen 2-7 
Restore Screen 2-11 
Save 2-8 

input commands 
Read Immediate 2-5 
Read Input Fields 2-6 
Read MDT Fields 2-7 
Read Screen 2-7 
Save 2-7 

Ins key 2-126 

insert cursor order 2-137 

insert mode 2-146 

Insert Mode indicator 2-147 

instructions (See commands) 


Interchange Record Separator control 


character 2-47 


internal clock feature (see clocking) 
IRS control character 2-47 
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Katakana 
character set 2-53 
fields 2-69 

keys 
aid-generating 2-117 
Signal 2-121 
special control 2-123 


LAPB frames 2-166 

LF control character 2-47 

lights (see indicators) 

Line Feed control character 2-47 

link-level control 1-1, 2-15 

local session identifier (see LSID) 

local station address 
description of 1-5, 1-7 
location of 2-160 

LSID 
contents of 2-159 
description of 1-7, 2-1 
determining 1-5 

Lustat command 2-31 


| 


Magnetic Stripe Reader feature 2-66 


mandatory enter fields 2-69 
mandatory fill fields 2-70 
MDT bit 

commands using 2-4 

description of 2-128 
modems 2-128 
modes 

display (see states) 

SDLC/SNA 2-129 

short hold mode 2-197 
monocase fields 2-70 
multinational character set 2-129 
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negative responses 2-132 
New Line control characters 2-47 
NL control character 2-47 
nonsequenced 
commands and responses 2-16 
SDLC frames 2-71 
normal locked state 2-145 
normal unlocked state 2-146 
NSA response 2-16 
NSI command and response 2-21 
NUL control character 2-47 
numeric only fields 2-70 
numeric shift fields 2-70 
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operator error codes 2-135 
orders 

insert cursor 2-137 

repeat to address 2-137 

set buffer address 2-137 

Start of field 2-137 

start of header 2-138 
output commands 

Clear Format Table 2-9 

Clear Unit 2-9 

description 2-9 

Restore Screen 2-11 

Roll 2-11 

Write Error Code 2-12 

Write to Display 2-13 
overview of 5250 

implementation of SDLC_ 1-1 

implementation of SNA_ 1-3 


[P| 


P/F bit 2-140 
pacing 2-24, 2-107, 2-140 
parameters 
control characters 2-39 
field control words (FCW) 2-65 
field format word (FFW) 2-68 
orders 2-136 
screen attributes 2-142 
PIU 2-165 


posthelp error state 2-146 
power-on state 2-147 
PP control character 2-47 
prehelp error state 2-147 
Print key 2-120 
print position 
control character 2-47 
defining 2-41 
printer 
buffer print mode 2-3 
code for 2-41 
data stream 2-51 
data stream, examples of 1-39 
protocols 1-26 
printer interface 2-112 
protocols (SNA) 
controller 1-22 
display 1-25 
printer 1-26 
PSH 2-172 


[a | 


QLLC 2-167 


[R] 


RA order 2-137 

read commands (see input commands) 
Read Input Fields command 2-6 
Read MDT Fields command 2-7 
read multiple status 1-27 

read orders 2-98 

Read Screen command 2-7 
Ready indicator 2-3 

Recfms command 2-32 

Record Backspace key 2-120 
REJ command and response 2-21 
relative horizontal move 2-41 
relative vertical move 2-41 
remote operations 1-1 

Repeat to Address order 2-137 
Reqms command 2-33 

Reqtest command 2-33 

request definite 1-4 

request exception 1-4 
resequencing 2-66 

reset multiple status 1-28 
responses 
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Bind 2-24 
negative 2-132 


RQD 1-4, 2-21 
RQE 1-4 
SDLC 2-15 
XID 2-17 


Restore Screen command 2-11 
reverse image 
Display Mode key sequence 2-123 
screen attributes 2-142 
RH 
chain locations 1-23 
code for 2-141 
right-adjust fields 2-70 
RNR command and response 2-20 
Roll command 2-11 
Roll keys 2-120 
RQD_ 1-4 
RQD command 2-21 ’ 
RQE 1-4 
RQI command 2-21 
RR command and response 2-20 
Rshutd command 2-33 
RU 2-142 
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Save command 2-8 
SBA order 2-137 
screen attributes 2-142 
SCS control characters (see control characters) 
SDLC 
errorcodes 2-144 
frame 2-71 
SDLC/X.25 error codes 2-144 
select option mode keys 2-4 
select options 2-73 
Selector Light Pen feature 2-67 
self-check feature 2-67 
sequence (see protocols) 
sessions 
commands (see Actlu, Bind, Dactlu, and Unbind) 
control of (see CD, Actlu, and Bind) 
definitions 1-4 
flow (see flow) 
partners 1-4 
paths 1-12 
protocols 1-23 
Set Buffer Address order 2-137 
Set Graphic Error Action control character 2-45 
Set Horizontal Format control character 2-44 


Set Vertical Format control character 2-44 
SF order 2-138 
SGEA 2-45 
SHF 2-44 
shift keys 2-126 
short hold mode 2-197 
Signal command 
command and response code 2-34 
keys that generate 2-121 
Signal keys 2-121 
signed numeric fields 2-70 
signing on 1-21 
SIM command 2-21 
SNA 
chainend 2-144 
commands 2-22 
description of 1-4 
headers (see RH and TH) 
protocol errors’ 1-10 
protocols 1-22 
RU 2-142 
sessions 1-14 
terminology 1-4, 1-23 
SNA/X.25. relationship 2-162 
SNRM command 2-16 
SOH order 2-139 
special control keys 2-123 
special function keys 
aid-generating 2-117 
signal 2-121 
special control 2-123 
special host 2-126 
SS message state 2-148 
Start of Field order 2-138 
Start of Header order 2-139 
states 
description 2-145 
hardware error 2-145 
normal locked 2-145 
normal unlocked 2-146 
posthelp error 2-146 
power-on 2-147 
prehelp error 2-147 
SS message 2-148 
system request 2-148 
station address 
controller 2-1 
local 1-7, 2-1 
LSID 1-7, 2-1 
work station 2-1 
supervisory (SDLC) frames 2-71 
Supervisory command and response 2-20 
SVC/PVC connection 2-163 
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SVF 2-44 

switches 
5224 Printer 1-8, 2-3 
5225 Printer 1-8, 2-3 
5251 Printer 1-8 
5256 Printer 1-8 

Sys Req key 2-128 

system request state 2-148 


Test command and response 2-16 
Test Request key 2-126 

TH 1-4, 2-159 

timing (see protocols) 

transmission 2-36 

transmission header’ 1-4, 2-159 
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Unbind command 2-35 

unprintable characters 
EBCDIC 2-51 
Katakana 2-53 
SGEA 2-52 
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video interface 2-109 
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work station address 
switches 1-5 


World Trade common carrier services 2-36 


Write Error Code command 2-12 
Write to Display command 2-13 
writing to a display 1-28 

writing to an IPDS Printer 1-27 
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X.25 data packet 2-175 
X.25 errors 2-182 
X.25 feature 2-37, 2-160 
X.25 formats 2-163 
XID 2-17 

XLCA adapter 2-37 


1200 bps Integrated Modem 2-160 
2400 bps Integrated Modem 2-160 
38LS modem (see 1200 bps) 

38LY modem (see 4800 bps) 

38NI modem (see 2400 bps) 

4800 bps Integrated Modem 2-160 
5294 control unit 2-36 
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